feat: Knoten-ID vor dem Titel mit optionalem Doppelpunkt; Alt+Klick pulst mit

Übliche Schreibweise ist jetzt `#auth: Backend` — die ID benennt den Knoten,
der Titel erläutert sie; vorn hat sie eine feste Stelle, an der das Auge sie
sucht. Der Doppelpunkt ist optional und reines Trennzeichen: Er gehört weder
zur ID noch zum Label und fällt beim Parsen weg, sonst wären `#auth` und
`#auth:` zwei verschiedene Adressen.

Geschluckt wird er nur mit folgendem Leerraum oder Zeilenende (Leerraum-Regel
wie bei `=`, `>`/`<`, `"`). Damit bleibt `#auth:#db` ID plus Abhängigkeit, und
ein Doppelpunkt im Titel bleibt stehen. Die ID-Erkennung selbst ist unverändert
— die Doppelpunkt-Gruppe ist optional; ein verlangtes `(?=\s|$)` hinter der ID
hätte bestehende Zeilen umgedeutet. Der Block-Kopf im Beschreibungsteil nimmt
den Doppelpunkt ebenfalls an.

Alle mitgelieferten Beispiele umgestellt (docs/examples/, INITIAL, llms.md);
SPEC §10 hat keine IDs. Legenden-Zeile hint_id in allen neun Sprachen.

Dazu: Alt+Klick im Textfeld zeigt jetzt dieselbe Hervorhebung wie der
Zeilenwechsel, Puls eingeschlossen — bisher unterdrückte focusNodeOfCaret()
ihn, um doppeltes Scrollen zu vermeiden, und ausgerechnet die ausdrückliche
Geste kam stiller an als das beiläufige Tippen. Getrennt über den neuen
Parameter highlightCurrentNode(moved, scroll): 'nearest' | 'center' | false.

7 neue Parser-Tests (197 gesamt). SPEC §1, D36 (Nachtrag), D25 (Nachtrag 2)
und llms.md nachgezogen.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
mhoennig
2026-08-23 07:31:45 +02:00
co-authored by Claude Fable 5
parent 099ee87bc1
commit ad2f3bab14
9 changed files with 190 additions and 32 deletions
+46
View File
@@ -49,6 +49,52 @@ describe('Parser — `#name` als Knoten-ID', () => {
});
});
/* Übliche Schreibweise: ID vor dem Titel, abgetrennt durch einen Doppelpunkt.
Der Doppelpunkt ist optional, gehört weder zur ID noch zum Label. */
describe('ID vor dem Titel, `#id: Titel`', () => {
it('schluckt den trennenden Doppelpunkt', () => {
const [n] = roots(`[ ] #auth: Auth-Modul (M)`);
expect([n.id, n.label, n.size]).toEqual(['auth', 'Auth-Modul', 'M']);
});
it('kommt ohne Doppelpunkt zum selben Ergebnis', () => {
const mit = roots(`[ ] #auth: Auth-Modul (M)`)[0];
const ohne = roots(`[ ] #auth Auth-Modul (M)`)[0];
expect([mit.id, mit.label]).toEqual([ohne.id, ohne.label]);
});
it('lässt den Doppelpunkt auch am Zeilenende weg', () => {
const [n] = roots(`[ ] Titel danach #auth:`);
expect([n.id, n.label]).toEqual(['auth', 'Titel danach']);
});
it('vertägt sich mit Abhängigkeiten in derselben Zeile', () => {
const {roots: r, warnings} = parse(`[ ] #api: API\n[ ] #ui: Oberfläche :#api`);
expect(r.map(n => [n.id, n.label, n.deps])).toEqual([
['api', 'API', []], ['ui', 'Oberfläche', ['api']],
]);
expect(warnings).toEqual([]);
});
it('lässt einen Doppelpunkt IM Label unberührt', () => {
const [n] = roots(`[ ] #auth: Regel: nur mit Token`);
expect([n.id, n.label]).toEqual(['auth', 'Regel: nur mit Token']);
});
it('schluckt nur einen Doppelpunkt mit folgendem Leerraum — `#auth:#db` bleibt Abhängigkeit', () => {
const {roots: r} = parse(`[ ] #db: Datenbank\n[ ] #auth:#db Login`);
expect(r[1].id).toBe('auth');
expect(r[1].deps).toEqual(['db']);
expect(r[1].label).toBe('Login');
});
it('nimmt den Doppelpunkt auch im Beschreibungsteil an', () => {
const {roots: r, warnings} = parse(`[ ] #auth: Auth\n---\n#auth:\n Erklärung.`);
expect(r[0].desc).toBe('Erklärung.');
expect(warnings).toEqual([]);
});
});
describe('Doppelte IDs — Warnung an der späteren Zeile', () => {
it('meldet die spätere Zeile und nennt die erste', () => {
const {warnings} = parse(`[ ] A #auth\n[ ] B\n[ ] C #auth`);