Skip to content

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.

5.3 KB
Raw Blame
/**
 * Monaco, eingebunden als ESM ueber Vite. Kein CDN, kein AMD-Loader.
 *
 * **Warum ESM und nicht der AMD-Weg aus spike/.** Der Spike lud Monaco ueber
 * `loader.js` aus `/node_modules/monaco-editor/min/vs`. Das war fuer einen
 * Wegwerf-Beweis richtig und fuer das Produkt falsch: der ausgelieferte Ordner
 * ist `dist/`, und der Server bettet genau das ein, was dort liegt
 * (scripts/embed-frontend.sh sammelt dist/ per find).
 * Ein AMD-Loader haette verlangt, `min/vs` daneben zu kopieren und den Pfad zur
 * Laufzeit zu raten. Als ESM-Import ist Monaco Teil des Bundles, und was Vite
 * gebaut hat, liegt vollstaendig in dist/.
 *
 * **Die Importpfade sind die von 0.56, nicht die aus der alten Anleitung.**
 * Die Vite-Rezepte im Netz schreiben `monaco-editor/esm/vs/editor/editor.api`.
 * Die `exports`-Tabelle von monaco-editor 0.56 bildet `./*` auf `./esm/vs/*.js`
 * ab, also loest genau dieser Pfad auf `esm/vs/esm/vs/editor/editor.api.js` auf
 * und existiert nicht. Richtig ist `monaco-editor/editor/editor.api`. Geprueft
 * mit `import.meta.resolve`, nicht geraten.
 *
 * **Die Sprachdienste fehlen mit Absicht.** Der volle Einstiegspunkt
 * (`import * as monaco from 'monaco-editor'`) zieht die TypeScript-, JSON-,
 * CSS- und HTML-Sprachdienste mit, also einen Typpruefer in einem Worker. Der
 * wuerde hier ueber eine Datei laufen, die der Server bei 500 Zeilen ABGESCHNITTEN
 * geliefert hat, und rote Wellenlinien unter Code malen, der nur deshalb
 * unvollstaendig aussieht. Eine Lese-Oberflaeche, die Fehler erfindet, ist
 * schlimmer als eine ohne Diagnosen.
 *
 * Deshalb `languages/definitions/register.all` und nicht `languages/register.all`:
 * die aeussere Fassung zieht am Ende ihrer Liste die vier Sprachdienste mit
 * herein, die innere sind nur die 81 Monarch-Definitionen. Faerbung ist damit
 * rein lexikalisch und behauptet nichts. Der Preis ist benannt: JSON hat keine
 * Monarch-Definition, weil seine Faerbung beim Sprachdienst liegt, also
 * erscheint eine .json-Datei ungefaerbt. Ungefaerbt ist ehrlich; falsch
 * unterringelt waere es nicht.
 *
 * Uebrig bleibt genau ein Worker, der Basis-Worker des Editors.
 */

import * as monaco from 'monaco-editor/editor/editor.api';
import 'monaco-editor/languages/definitions/register.all';
import EditorWorker from 'monaco-editor/editor/editor.worker?worker';

/** Der Name des Themes, das aus den Tokens gebaut ist. */
export const ATLAS_THEME = 'atlas-phosphor';

let prepared = false;

/**
 * Die Farben des Editors aus denselben Tokens wie das uebrige Chrome.
 *
 * Monaco kann keine CSS-Variablen lesen, also stehen die Werte hier ein zweites
 * Mal. Das ist die eine Doppelung, die dieses Design sich leistet, und sie
 * steht direkt neben tokens.css, damit sie beim naechsten Griff in die Palette
 * mitwandert.
 */
function defineTheme(): void {
    monaco.editor.defineTheme(ATLAS_THEME, {
        base: 'vs-dark',
        inherit: true,
        rules: [
            { token: '', foreground: 'c3d4cd', background: '0a0e0d' },
            { token: 'comment', foreground: '4f6b60', fontStyle: 'italic' },
            { token: 'keyword', foreground: '33ff99' },
            { token: 'string', foreground: '8fd6ae' },
            { token: 'number', foreground: 'e0a06a' },
            { token: 'regexp', foreground: 'e0a06a' },
            { token: 'type', foreground: '66d9e8' },
            { token: 'type.identifier', foreground: '66d9e8' },
            { token: 'delimiter', foreground: '7d9a8e' },
            { token: 'delimiter.bracket', foreground: '7d9a8e' },
            { token: 'tag', foreground: '66d9e8' },
            { token: 'attribute.name', foreground: '8fd6ae' },
            { token: 'invalid', foreground: 'ff5f8f' },
        ],
        colors: {
            'editor.background': '#0a0e0d',
            'editor.foreground': '#c3d4cd',
            'editorGutter.background': '#0a0e0d',
            'editorLineNumber.foreground': '#31473e',
            'editorLineNumber.activeForeground': '#33ff99',
            'editor.lineHighlightBackground': '#0f1513',
            'editor.lineHighlightBorder': '#0f1513',
            'editor.selectionBackground': '#12251d',
            'editor.inactiveSelectionBackground': '#12251d',
            'editorCursor.foreground': '#33ff99',
            'editorWhitespace.foreground': '#1d2926',
            'editorIndentGuide.background1': '#151f1c',
            'editorIndentGuide.activeBackground1': '#1d2926',
            'scrollbarSlider.background': '#1d292688',
            'scrollbarSlider.hoverBackground': '#1d2926cc',
            'scrollbarSlider.activeBackground': '#1f7f4ccc',
            'editorOverviewRuler.border': '#0a0e0d',
        },
    });
}

/**
 * Monaco einmalig einrichten: Worker anmelden, Theme anlegen.
 *
 * Zweimal aufrufen ist erlaubt und tut beim zweiten Mal nichts. Der Reader wird
 * unter React StrictMode zweimal montiert, und ein zweiter Worker waere ein
 * zweiter Prozess fuer nichts.
 */
export function prepareMonaco(): typeof monaco {
    if (prepared) {
        return monaco;
    }
    // Monaco deklariert `MonacoEnvironment` selbst als globale Variable; hier
    // wird nur zugewiesen. Ein zweites `declare global` haette den Typ neu
    // behauptet, statt den vorhandenen zu benutzen.
    self.MonacoEnvironment = {
        getWorker: () => new EditorWorker(),
    };
    defineTheme();
    prepared = true;
    return monaco;
}

export { monaco };