Skip to content

Fehlerbehebung

Das Symptom der Zeile zuordnen, bevor etwas geändert wird. Mehrere davon sehen wie ein kaputter Build aus und werfen nichts. Container und Stacking: Einbetten.

SymptomUrsacheWas tun
Chrome rendert, Klicks / Drags / Tasten tun nichtsEine zweite Vue-Reactivity-Instanz. @templatical/core (oder ein anderes Vue-nutzendes @templatical/*-Paket) steht in den dependencies der App, daher sind Refs, die der Editor erzeugt, für diese zweite WeakMap unsichtbar.Diese Pakete nicht in die dependencies der App aufnehmen. Der Editor bundelt sie bereits.
Editor mountet, Layout fehlt@templatical/editor/style.css wurde nicht importiert. Die exports-Map löst diesen Subpath zu dist/style.css auf.Das Stylesheet neben init() importieren. tailwindcss nicht als Peer installieren — es ist in diese Datei einkompiliert.
Dialoge abgeschnitten, unter Host-Chrome, oder ein Drag-Ghost der driftetEin Vorfahre des Containers ist Containing Block für position: fixed: transform, filter, backdrop-filter, perspective, will-change, contain, isolation, opacity unter 1, oder ein positioniertes Element mit z-index.Die Eigenschaft an Vorfahren entfernen, oder außerhalb dieses Stacking-Kontexts mounten.
Letzte Sidebar-Einträge / Footer abgeschnitten, kein ScrollDer Container hat keine definite Höhe. Der Editor füllt das Elternelement; ohne Höhe nutzt er eine kleine Anti-Collapse-Untergrenze, das Chrome nimmt trotzdem echte Höhe an.Dem Container eine echte Höhe geben (100% eines bemessenen Parents, oder px/vh).
React 18 StrictMode: Extra-Editoren, undichte Listenerinit() ist asynchron. StrictMode unmountet den Effect, bevor das Promise auflöst, daher wird die Instanz nie gespeichert und nie unmount()ed.Die Instanz, die gerade fertig wurde, unmounten, wenn der Effect abgebrochen war. Siehe Installation.
toHtml() wirft / toMjml() verlangt ein PaketDas SDK liefert keinen MJML-Compiler. toMjml() lädt @templatical/renderer lazy. HTML ist jede MJML-Bibliothek, render.compileMjml oder template-tools render --format html.Den Renderer-Peer für MJML installieren. HTML auf dem Server kompilieren. So funktioniert das Rendering.
require('@templatical/editor') schlägt fehlNur ESM. Kein main, kein CJS, kein UMD.import verwenden. Eine reine-CJS-App braucht einen Bundler, der ESM konsumieren kann.
Theme-Tokens verschwinden nach all: initial am ContainerVererbung überquert die Shadow-Grenze. Ein Reset am Container löscht --tpl-user-*, die Theming-Oberfläche, und kann die Höhenkette zerbrechen.Den Container nicht resetten. Der Editor neutralisiert Host-Typografie an der eigenen Wurzel.

Der diagnose-Modus des Agent Skills prüft dieselbe Tabelle gegen einen bestehenden init()-Aufruf.