fix(preview): route the preview through the shared sanitize contract - #384
Merged
Merged
Conversation
sftwrdotdev#376 introduced `src/lib/utils/sanitize.ts` as the single markdown sanitize policy, and the comment on its `FORBID_TAGS: ['style']` entry argues the preview case specifically: the sanitized HTML is injected into the app's own document, where a document `<style>` can hide the title bar or turn any selector into an outbound beacon. Only the export path ever imported it. The preview kept a local copy of the URI regexp and passed `ALLOWED_URI_REGEXP` alone, so `<style>` - which DOMPurify allows by default, CSS unfiltered - reached the live document. Measured in a browser against the pinned DOMPurify build: the title bar's computed `display` became `none` and the outbound request for the beacon appears in `performance.getEntriesByType('resource')`. The app CSP permits both halves. The deleted regexp was byte-identical to the shared one, so no URI behaviour changes; the only delta is that author `<style>` is dropped. The order difference between the two sinks is left alone and now documented: export sanitizes first because its bytes leave the app and filtering Markpad's own generated markup could silently delete part of the export; the preview sanitizes last because it has no second line of defence, so the string reaching `{@html}` must BE the sanitizer's output with no round trip after it. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This was referenced Aug 2, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The gap
#376 introduced
src/lib/utils/sanitize.tsas the single markdown sanitize policy. The comment on itsFORBID_TAGS: ['style']entry argues the preview case specifically:Only
export.tsever imported it. The preview kept its own copy of the URI regexp and passedALLOWED_URI_REGEXPalone — so the one tag that comment was written about was the one the preview did not forbid. Providing the correct path is not the same as closing the wrong one.Measured, not argued
Real DOMPurify (the pinned 3.4.12 build), the real
processMarkdownHtmlfrom this branch, injected into a live document containing a.titlebar, in the preview's real order:<style>.titlebarcomputeddisplaybodycomputedbackground-image{ALLOWED_URI_REGEXP}— beforenoneurl("https://attacker.example/beacon")MARKDOWN_SANITIZE_CONFIG— afterflexnoneThe beacon is not hypothetical: after injection,
performance.getEntriesByType('resource')lists the outbound request. Both halves are permitted by the shipped CSP (style-src 'self' 'unsafe-inline' …,img-src 'self' asset: https: …).The fix
Import
sanitizeMarkdownHtml; delete the localmarkdownLinkExtensions/markdownLinkExtensionPattern/allowedMarkdownUriPattern.sanitize.tsis unchanged — the shared config was already right.The deleted regexp was verified byte-identical to the shared one (
String(local) === String(shared)→true), so no URI behaviour changes. The only behavioural delta is that an author's<style>is dropped.The order difference is deliberate now, not accidental
git log -S "import DOMPurify"shows the preview's sanitize call arrived ineb9a1c7(MermaidforeignObjectsupport), bolted onto the render sink where the processed HTML was already cached. The ordering was never a decision.But the resulting order is the right one for this sink, and it is kept:
exportSanitize.test.tspins that order.{@html}must be the sanitizer's output, with no parse/serialize round trip after the filter ran.Both rationales are now in a comment at the call site, and a test fails if the preview call is moved ahead of processing, so the asymmetry cannot be "tidied up" later.
The render pipeline was verified, not assumed
Measured in a browser, on a fixture with headings/folds, task items, a folded callout,
<img style="width:50%">, video replacement, a YouTube thumbnail, a table, code blocks and inline + display math:processMarkdownHtmloutput contains no<style>; the fixture sanitizes byte-identically under the old and new configs.<style>(KaTeX's CSS is a real imported stylesheet).styleattributes still survive;onerroris still dropped.<style>block —#id-scoped fonts, stroke widths, dash patterns. It is unaffected: mermaid runs on the live DOM after{@html sanitizedHtml}, through the separatesanitizeDiagramSvg, which needsforeignObject(the document policy forbids it) and needs that inline<style>(the document policy forbids it too — applying the shared config to a diagram flattens its fonts and edge styling, measured). The two policies must stay separate, and a test now asserts the split so a future "let's unify these" has to read why.Alignment with other editors
<style>and<meta>won't be applied either."<style>.default-src 'none', so document CSS physically cannot reach the editor chrome. Markpad injects into its own document, so stripping is the equivalent available here.Tests
scripts/previewSanitize.test.ts(new). DOMPurify cannot run undernode --test(no DOM, and the repo deliberately has no test-only DOM dependency — the shim from #378 is scoped toprocessMarkdownHtmland should not grow into a general parser), so the test pins the wiring chain the wayexportSanitize.test.tsdoes and records the browser measurements verbatim in its header.It also adds a call-site allowlist for
DOMPurify.sanitize(acrosssrc/— the durable form of this bug, since no compiler can see a new private policy appearing.npm test364 / 364,npm run check0 errors 0 warningsNot covered
processMarkdownHtml+ real live-DOM computed styles + a real outbound request, plus the CSP read fromtauri.conf.json; I did not launchtauri dev.<style>is emitted from user-controlled diagram source, so a CSS breakout viaclassDef/styledirectives is conceivable. One attempt was rejected by mermaid's own lexer, but one probe is not an audit. Worth a separate look.npm ls dompurifyreports the installed tree asinvalid(3.3.1 present despite the 3.4.12 pin/override). All numbers above were re-measured against a freshly fetched 3.4.12. Worth checking separately; this PR does not touch it.🤖 Generated with Claude Code