Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.
TypeScript adhdagent-orchestrationai-agentscanvasclaude-codecodexcoding-agentsdeveloper-toolselectrongeminilinuxmacosmultiplexeropencodeparallel-agentsterminalterminal-emulatorterminal-multiplexertmuxworkspace-manager
import { describe, expect, it } from 'vitest'
import {
CELL_STRIDE,
FLAG_BOLD,
FLAG_SELECTED,
packColor,
readCell,
unpackColor,
writeCell
} from './cells'
describe('glyphgrid cells', () => {
it('packColor/unpackColor round-trip all channels', () => {
const c = packColor(0x12, 0x34, 0x56, 0xff)
expect(unpackColor(c)).toEqual({ r: 0x12, g: 0x34, b: 0x56, a: 0xff })
})
it('writeCell/readCell round-trip through a shared buffer', () => {
const buf = new Uint32Array(3 * CELL_STRIDE)
writeCell(buf, 2, 4242, packColor(1, 2, 3, 255), packColor(9, 8, 7, 255), FLAG_BOLD | FLAG_SELECTED)
const cell = readCell(buf, 2)
expect(cell.glyph).toBe(4242)
expect(cell.flags).toBe(FLAG_BOLD | FLAG_SELECTED)
expect(unpackColor(cell.fg)).toEqual({ r: 1, g: 2, b: 3, a: 255 })
// Neighboring cells untouched:
expect(readCell(buf, 1)).toEqual({ glyph: 0, fg: 0, bg: 0, flags: 0 })
})
it('pins the absolute byte order and lane positions', () => {
// The GL binding cannot re-derive either of these: gl-webgl2 binds lane 0..3 as one uvec4
// instanced attribute and the fragment shader unpacks each color with `c & 255u` as RED.
// A round-trip test would still pass if BOTH sides were swapped, so the absolute values are
// pinned here — this is the only place the wire format is stated, not merely echoed.
expect(packColor(0x12, 0x34, 0x56, 0x78)).toBe(0x78563412)
const buf = new Uint32Array(CELL_STRIDE)
const fg = packColor(1, 2, 3, 255)
const bg = packColor(9, 8, 7, 255)
writeCell(buf, 0, 4242, fg, bg, FLAG_BOLD)
expect(buf[0]).toBe(4242)
expect(buf[1]).toBe(fg)
expect(buf[2]).toBe(bg)
expect(buf[3]).toBe(FLAG_BOLD)
})
it('a packed color equals the lane it was written to, even with alpha >= 128', () => {
// `0xff << 24` is negative in JS, so an unguarded packColor returns a signed int while the
// Uint32Array lane reads back unsigned — the two would never compare equal, and a
// dirty-check comparing a fresh packColor() against readCell() would fire forever.
const opaque = packColor(1, 2, 3, 255)
expect(opaque).toBeGreaterThan(0)
const buf = new Uint32Array(2 * CELL_STRIDE)
writeCell(buf, 0, 65, opaque, packColor(9, 8, 7, 200), FLAG_BOLD)
const cell = readCell(buf, 0)
expect(cell.fg).toBe(opaque)
expect(cell.bg).toBe(packColor(9, 8, 7, 200))
})
})