termplot/code/termplot/ts/termplot/app/cli/geometry.ts at main · astrohackerlabs/termplot · GitHub

Repository navigation

History

103 lines (94 loc) · 3.09 KB

Raw

100

101

102

103

/** Cell geometry. Overlay SetOverlay uses the inner rect. */

export interface PaneGeometry {

col: number;

row: number;

width: number;

height: number;

}

export interface OverlayLayout {

pane: { width: number; height: number };

/** Inner webview — SetOverlay / CaptureOverlay. */

overlay: PaneGeometry;

/** Outer box including the 1-cell ring, or equal to overlay if unbordered. */

outer: PaneGeometry;

bordered: boolean;

}

/** Landscape default in pixels (~2:1 cell aspect → 100×32 is wider than tall). */

export const DEFAULT_MAX_COLS = 100;

export const DEFAULT_MAX_ROWS = 32;

export function fullPaneGeometry(columns: number, rows: number): PaneGeometry {

const width = Math.max(1, Math.floor(columns) || 80);

const height = Math.max(1, Math.floor(rows) || 24);

return { col: 0, row: 0, width, height };

}

/** Read pane size from process stdout or env overrides (tests). */

export function readTerminalGeometry(

env: NodeJS.ProcessEnv = process.env,

stdout: { columns?: number; rows?: number } = process.stdout,

): PaneGeometry {

if (env.TERMPLOT_COLS && env.TERMPLOT_ROWS) {

return fullPaneGeometry(

Number(env.TERMPLOT_COLS),

Number(env.TERMPLOT_ROWS),

);

}

const columns = stdout.columns ?? 80;

const rows = stdout.rows ?? 24;

return fullPaneGeometry(columns, rows);

}

function positiveCell(n: number, fallback: number): number {

const v = Math.floor(n);

if (!Number.isFinite(v) || v < 1) return fallback;

return v;

}

/**

* Center a landscape-capped overlay. Max is a ceiling on the inner

* webview. Border is a 1-cell ring when the pane is at least 3×3.

export function overlayLayout(

paneCols: number,

paneRows: number,

maxCols: number = DEFAULT_MAX_COLS,

maxRows: number = DEFAULT_MAX_ROWS,

): OverlayLayout {

const paneW = positiveCell(paneCols, 80);

const paneH = positiveCell(paneRows, 24);

const maxW = positiveCell(maxCols, DEFAULT_MAX_COLS);

const maxH = positiveCell(maxRows, DEFAULT_MAX_ROWS);

const pane = { width: paneW, height: paneH };

let bordered = paneW >= 3 && paneH >= 3;

if (bordered) {

const innerW = Math.max(1, Math.min(paneW - 2, maxW));

const innerH = Math.max(1, Math.min(paneH - 2, maxH));

const outerW = innerW + 2;

const outerH = innerH + 2;

if (outerW > paneW || outerH > paneH || innerW < 1 || innerH < 1) {

bordered = false;

} else {

const outerCol = Math.floor((paneW - outerW) / 2);

const outerRow = Math.floor((paneH - outerH) / 2);

return {

pane,

overlay: {

col: outerCol + 1,

row: outerRow + 1,

width: innerW,

height: innerH,

outer: {

col: outerCol,

row: outerRow,

width: outerW,

height: outerH,

bordered: true,

};

}

const w = Math.max(1, Math.min(paneW, maxW));

const h = Math.max(1, Math.min(paneH, maxH));

const col = Math.floor((paneW - w) / 2);

const row = Math.floor((paneH - h) / 2);

const overlay = { col, row, width: w, height: h };

return { pane, overlay, outer: overlay, bordered: false };

}

termplot/code/termplot/ts/termplot/app/cli/geometry.ts at main · astrohackerlabs/termplot · GitHub

Repository navigation

Expand file tree

Breadcrumbs

geometry.ts

Latest commit

History

Breadcrumbs

geometry.ts

File metadata and controls