Local code intelligence for developers and AI agents. Connect code, docs and infrastructure in a persistent graph, with CBM Lens, MCP tools, agent integrations and change-aware test selection.
C aiderastclaude-codecode-analysiscode-intelligencecodexcursorcypherdeveloper-toolsgemini-cligraph-visualizationkilocodeknowledge-graphmcpmcp-servermodel-context-protocolopencodesqlitetree-sitterwindsurf
/**
* Die Rechnung hinter dem eigenen Tooltip, ohne Browser.
*
* Der Fall, der diesen Zyklus ausgeloest hat, steht als erster Test da: der
* Screenshot des Nutzers vom 2026-08-29 zeigte den Tooltip der Kopfzeile ueber
* dem Detail-Regler und ueber den Chips darunter. Genau diese Lage darf die
* Rechnung nicht mehr waehlen.
*/
import { describe, expect, it } from 'vitest';
import {
HINT_PROTECTED,
explainsMore,
overlapArea,
placeHint,
} from './tooltip-model';
const viewport = { width: 1680, height: 1050 };
describe('placeHint', () => {
it('stellt den Kasten unter den Ausloeser, wenn dort nichts Geschuetztes liegt', () => {
const placed = placeHint({
anchor: { x: 100, y: 100, width: 80, height: 20 },
size: { width: 200, height: 40 },
viewport,
protect: [],
});
expect(placed.side).toBe('below');
expect(placed.covered).toBe(0);
expect(placed.fits).toBe(true);
expect(placed.y).toBeGreaterThan(120);
});
it('verdeckt nie seinen eigenen Ausloeser', () => {
for (const side of ['below', 'above', 'right', 'left'] as const) {
void side;
}
const anchor = { x: 400, y: 400, width: 120, height: 24 };
const placed = placeHint({ anchor, size: { width: 300, height: 60 }, viewport, protect: [] });
expect(overlapArea({ ...anchor }, {
x: placed.x,
y: placed.y,
width: 300,
height: 60,
})).toBe(0);
});
/*
* Der Befund vom 2026-08-29, als Zahlen.
*
* Die Kopfzeile des Graph-Panels liegt oben in der rechten Spalte, der
* Detail-Regler und die Chips liegen unmittelbar darunter. "Unter dem
* Ausloeser" ist damit besetzt, und die Rechnung muss ausweichen statt
* darueberzulegen.
*/
it('weicht aus, wenn unter dem Ausloeser ein Regler steht', () => {
const anchor = { x: 1240, y: 120, width: 120, height: 18 };
const slider = { x: 1240, y: 150, width: 400, height: 90 };
const placed = placeHint({
anchor,
size: { width: 300, height: 70 },
viewport,
protect: [slider],
});
expect(placed.covered).toBe(0);
expect(overlapArea(slider, { x: placed.x, y: placed.y, width: 300, height: 70 })).toBe(0);
});
it('bleibt im Fenster, auch wenn der Ausloeser am Rand steht', () => {
const placed = placeHint({
anchor: { x: 1660, y: 1030, width: 16, height: 16 },
size: { width: 300, height: 70 },
viewport,
protect: [],
});
expect(placed.x).toBeGreaterThanOrEqual(0);
expect(placed.y).toBeGreaterThanOrEqual(0);
expect(placed.x + 300).toBeLessThanOrEqual(viewport.width);
expect(placed.y + 70).toBeLessThanOrEqual(viewport.height);
});
/*
* Total: gibt es gar keine freie Lage, kommt trotzdem eine heraus, und sie
* sagt mit `covered`, was sie kostet. Eine Rechnung, die in diesem Fall
* nichts zurueckgibt, waere eine Oberflaeche ohne Tooltip an genau der
* Stelle, an der jemand ihn braucht.
*/
it('waehlt die guenstigste Lage, wenn keine ganz frei ist', () => {
const anchor = { x: 800, y: 500, width: 40, height: 20 };
const everywhere = { x: 0, y: 0, width: viewport.width, height: viewport.height };
const placed = placeHint({
anchor,
size: { width: 200, height: 40 },
viewport,
protect: [everywhere],
});
expect(placed.covered).toBeGreaterThan(0);
expect(['below', 'above', 'right', 'left']).toContain(placed.side);
});
/*
* Der Befund vom 2026-08-30 (`npm run smoke:w8b`): der Tooltip einer
* Schrittzeile lag ueber der Kommandozeile. Der Ausloeser stand so weit
* unten, dass jede der zwoelf Lagen an den unteren Fensterrand geklemmt
* wurde, und dort steht die Kommandozeile. Zehn Pixel darueber war frei.
*/
it('schiebt den Kasten aus der Kommandozeile, statt ihn an den Rand zu klemmen', () => {
const commandLine = { x: 0, y: 1010, width: viewport.width, height: 40 };
const placed = placeHint({
anchor: { x: 700, y: 1020, width: 100, height: 20 },
size: { width: 228, height: 27 },
viewport,
protect: [commandLine],
});
expect(placed.covered).toBe(0);
expect(overlapArea(
{ x: placed.x, y: placed.y, width: 228, height: 27 },
commandLine,
)).toBe(0);
expect(placed.y + 27).toBeLessThanOrEqual(commandLine.y);
});
/*
* Geschoben wird nur, wenn es ganz frei wird. Ein Kasten, der von einem
* Hindernis auf das naechste rutscht, waere derselbe Fehler mit anderen
* Zahlen; dann bleibt die guenstigste Lage stehen und sagt in `covered`,
* was sie kostet.
*/
it('bleibt stehen, wenn daneben auch kein Platz ist', () => {
const everywhere = { x: 0, y: 0, width: viewport.width, height: viewport.height };
const placed = placeHint({
anchor: { x: 800, y: 500, width: 40, height: 20 },
size: { width: 200, height: 40 },
viewport,
protect: [everywhere],
});
expect(placed.covered).toBeGreaterThan(0);
});
it('laesst die freien Lagen unangetastet', () => {
const placed = placeHint({
anchor: { x: 100, y: 100, width: 80, height: 20 },
size: { width: 200, height: 40 },
viewport,
protect: [{ x: 900, y: 900, width: 100, height: 100 }],
});
expect(placed.covered).toBe(0);
expect(placed.x).toBe(100);
expect(placed.y).toBe(126);
});
it('nennt seine geschuetzten Flaechen als Daten, mit Grund', () => {
expect(HINT_PROTECTED.length).toBeGreaterThanOrEqual(2);
for (const entry of HINT_PROTECTED) {
expect(entry.selector.length).toBeGreaterThan(0);
expect(entry.reason.length).toBeGreaterThan(20);
}
});
});
describe('explainsMore', () => {
it('erkennt eine blosse Wiederholung des sichtbaren Textes', () => {
expect(explainsMore('GALAXY', 'GALAXY')).toBe(false);
expect(explainsMore('galaxy', 'GALAXY')).toBe(false);
expect(explainsMore('76 nodes', 'the graph shows 76 nodes today')).toBe(false);
});
it('erkennt einen Satz, der mehr sagt als das Etikett', () => {
expect(explainsMore('hide the graph panel: the header stays', 'collapse galaxy')).toBe(true);
expect(explainsMore('src/services/userService.ts', 'userService.ts')).toBe(true);
});
it('haelt einen leeren Satz fuer keine Erklaerung', () => {
expect(explainsMore('', 'anything')).toBe(false);
expect(explainsMore(' ', 'anything')).toBe(false);
});
});