Files
Laufzettel/src/components/markdown.tsx
T
Florian WildeandClaude Opus 5 548c090562
Prüfung / pruefung (pull_request) Canceled after 0s
Prüfung / pruefung (push) Canceled after 0s
Prüfung / e2e (pull_request) Canceled after 0s
Prüfung / e2e (push) Canceled after 0s
feat(vorlagen): Editor, Liste und Versionsgeschichte
Der Redakteur baut eine Vorlage jetzt vollstaendig in der Oberflaeche: Liste mit
Suche und Filtern, Editor mit Abschnitten, Schritten und Variablen, Vorschau mit
Beispielwerten, Veroeffentlichen mit Aenderungsnotiz, Versionsgeschichte.

Sortiert wird mit dem Finger, der Maus, der Tastatur **und** zwei Knoepfen an
jeder Zeile — ein Touch-Drag gelingt auf einem 390-px-Geraet nicht jedem, und
die Reihenfolge ist fachlich zu wichtig fuer nur einen Weg. Schritte, Variablen
und Abschnitte klappen zu: dieselbe Vorlage misst am Handy 3 482 statt 16 986 px.

- src/lib/platzhalter.ts als einzige Quelle der eingebauten Platzhalter; der
  Editor warnt vor unbekannten, blockiert aber nichts
- Hilfetexte als Markdown ohne rohes HTML, Bilder als Alternativtext
- Erste Playwright-Tests: der Editor wird durch die Oberflaeche gefahren

Wichtigster Befund des Meilensteins: `next dev` hydriert in dieser Umgebung
ueberhaupt nicht — die Seiten sehen richtig aus, aber kein Knopf tut etwas
(2 von 1302 Elementen tragen React-Knoten, im gebauten Stand 1281 von 1296).
Nicht an diesem Code: auch ohne proxy.ts und ohne output: standalone. Ein
Screenshot beweist damit nichts ueber Bedienbarkeit. Oberflaechen werden ab
sofort gegen `pnpm build && pnpm start` abgenommen, und was nur mit angehaengtem
React gelingt, gehoert in einen Playwright-Test.

Der unabhaengige Review fand zwei Blocker: eine abgelaufene Anmeldung haette im
Editor jede ungespeicherte Arbeit vernichtet (der Rechtefehler lief bis in Nexts
Fehlergrenze), und das Speichern der Kopfdaten loeste eine archivierte
Kundenzuordnung stillschweigend auf. Dazu sechs weitere Befunde, alle behoben.

496 Tests gruen (vorher 428), dazu 5 E2E-Tests.

Schliesst #010

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-25 10:22:33 +02:00

67 lines
2.7 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import ReactMarkdown from "react-markdown";
import remarkGfm from "remark-gfm";
/**
* Hilfetexte als Markdown – ohne rohes HTML.
*
* `react-markdown` laesst rohes HTML von sich aus fallen; `rehype-raw` wuerde es
* wieder einschalten und ist deshalb bewusst nicht installiert. Ein Redakteur
* darf Hilfetexte schreiben, aber kein Skript in die Abarbeitungsansicht
* bringen, die jeder Techniker oeffnet.
*
* Links oeffnen in einem neuen Tab mit `rel="noreferrer"`, damit der Lauf beim
* Klick nicht verlassen wird und die Zielseite nichts ueber die Herkunft erfaehrt.
*/
export function Markdown({ text, className }: { text: string; className?: string }) {
return (
<div className={`markdown text-sm text-nebentext ${className ?? ""}`}>
<ReactMarkdown
remarkPlugins={[remarkGfm]}
components={{
/*
* `react-markdown` leert den `href`, wenn das Protokoll nicht erlaubt
* ist. Ein `<a href="">` laedt beim Klick die aktuelle Seite in einem
* neuen Tab — verwirrender als gar kein Verweis. Der Text bleibt
* stehen, nur das Anklickbare faellt weg.
*/
a: ({ href, children }) =>
href ? (
<a
href={href}
target="_blank"
rel="noreferrer"
className="text-akzent underline underline-offset-2"
>
{children}
</a>
) : (
<span className="text-nebentext">{children}</span>
),
/*
* Bilder werden **nicht** gerendert, sondern als Alternativtext
* gezeigt. Ein Bild in einem Hilfetext laege auf einem fremden Host,
* und `img-src` erlaubt nur `self`, `data:` und `blob:` — es wuerde
* also ohnehin nie erscheinen, nur ein kaputtes Symbol hinterlassen.
* Anhaenge sind fuer Phase 2 vorgesehen; bis dahin ist der Text
* ehrlicher als ein leerer Rahmen.
*/
img: ({ alt }) => <span className="text-nebentext">[Bild{alt ? `: ${alt}` : ""}]</span>,
code: ({ children }) => (
<code className="mono rounded bg-flaeche-hoch px-1 py-0.5 text-[0.9em]">{children}</code>
),
pre: ({ children }) => (
<pre className="mono overflow-x-auto rounded-karte border border-linie bg-grund p-3 text-xs">
{children}
</pre>
),
ul: ({ children }) => <ul className="list-disc pl-5">{children}</ul>,
ol: ({ children }) => <ol className="list-decimal pl-5">{children}</ol>,
p: ({ children }) => <p className="[&:not(:first-child)]:mt-2">{children}</p>,
}}
>
{text}
</ReactMarkdown>
</div>
);
}