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 {
defaultWallpaper,
GRADIENT_WALLPAPERS,
nextShuffleClip,
normalizeWallpaper,
parseAerialId,
recentWallpaperImage,
wallpaperChoice,
wallpapersToKeep
} from './wallpaper'
describe('defaultWallpaper (Liquid Glass chosen with no wallpaper)', () => {
it('takes the first still (the scan puts Sonoma Horizon first)', () => {
expect(defaultWallpaper([{ id: 'mac:a' }, { id: 'mac:b' }])).toEqual({ kind: 'preset', id: 'mac:a' })
})
it('falls back to a gradient where there are no stills', () => {
const w = defaultWallpaper([])
expect(w).toEqual({ kind: 'preset', id: GRADIENT_WALLPAPERS[0].id })
expect(normalizeWallpaper(w)).toEqual(w)
})
})
describe('recent wallpaper image (choosing a preset keeps the last import)', () => {
const img = { kind: 'image', path: '/ud/wallpapers/' + 'a'.repeat(40) + '.png' } as const
const sunrise = { kind: 'preset', id: GRADIENT_WALLPAPERS[0].id } as const
it('leaving an image for a preset records it as the recent image', () => {
expect(wallpaperChoice(img, sunrise)).toEqual({ desktopWallpaper: sunrise, recentWallpaperImage: img.path })
})
it('choosing an image records it; preset to preset leaves the recent image alone', () => {
expect(wallpaperChoice(sunrise, img)).toEqual({ desktopWallpaper: img, recentWallpaperImage: img.path })
expect(wallpaperChoice(sunrise, { kind: 'none' })).toEqual({ desktopWallpaper: { kind: 'none' } })
})
it('the prune keeps both the choice and the recent image; junk is ignored', () => {
expect(wallpapersToKeep({ desktopWallpaper: sunrise, recentWallpaperImage: img.path })).toEqual([sunrise, img])
expect(recentWallpaperImage(42)).toBeNull()
expect(recentWallpaperImage('')).toBeNull()
})
})
describe('normalizeWallpaper system-still prefixes', () => {
it('round-trips mac: and win: still ids', () => {
expect(normalizeWallpaper({ kind: 'preset', id: 'mac:Sonoma.heic' })).toEqual({ kind: 'preset', id: 'mac:Sonoma.heic' })
expect(normalizeWallpaper({ kind: 'preset', id: 'win:Windows/img0.jpg' })).toEqual({
kind: 'preset',
id: 'win:Windows/img0.jpg'
})
})
it('still collapses an unknown prefix to none', () => {
expect(normalizeWallpaper({ kind: 'preset', id: 'linux:x.jpg' })).toEqual({ kind: 'none' })
expect(normalizeWallpaper({ kind: 'preset', id: 'windows:x.jpg' })).toEqual({ kind: 'none' })
})
})
describe('aerial ids', () => {
const U = '00BA71CD-2C54-415A-A68A-8358E677D750'
it('accepts aerial: and aerial-shuffle: with a UUID', () => {
expect(normalizeWallpaper({ kind: 'preset', id: `aerial:${U}` })).toEqual({ kind: 'preset', id: `aerial:${U}` })
expect(normalizeWallpaper({ kind: 'preset', id: `aerial-shuffle:${U}` })).toEqual({
kind: 'preset',
id: `aerial-shuffle:${U}`
})
expect(parseAerialId(`aerial-shuffle:${U}`)).toEqual({ uuid: U, shuffle: true })
})
it('rejects anything but a UUID after the prefix (paths included)', () => {
for (const bad of ['aerial:', 'aerial:Dubai', `aerial:${U}.mov`, `aerial:../${U}`, `aerial-shuffle:${U}/x`, 'aerial-x:' + U]) {
expect(normalizeWallpaper({ kind: 'preset', id: bad })).toEqual({ kind: 'none' })
}
})
})
describe('nextShuffleClip', () => {
it('never repeats the current clip while another is available', () => {
const clips = ['a', 'b', 'c']
for (let i = 0; i < 50; i++) {
const r = i / 50
expect(nextShuffleClip(clips, 'b', () => r)).not.toBe('b')
}
expect(nextShuffleClip(['a', 'b'], 'a', () => 0.99)).toBe('b')
expect(nextShuffleClip(clips, 'a', () => 1)).not.toBe('a') // random() === 1 stays in range
})
it('a single clip repeats itself; none is null', () => {
expect(nextShuffleClip(['a'], 'a')).toBe('a')
expect(nextShuffleClip([], 'a')).toBeNull()
expect(nextShuffleClip(['a', 'b'], null, () => 0)).toBe('a')
})
})