feat: Typst-powered accessible PDF export (PDF/UA-1)

.github/workflows/build.yml

@@ -37,6 +37,9 @@ jobs:
       - name: Lint packages
         run: vp lint
 
+      - name: Install PDF tooling (veraPDF conformance gate + poppler visual snapshots)
+        run: bash tests/scripts/install-pdf-tooling.sh
+
       - name: Run unit tests
         run: vp run test
 
@@ -110,6 +113,9 @@ jobs:
         with:
           name: e2e-attachments-${{ matrix.browser }}-${{ matrix.shardIndex }}
           path: tests/.vitest-attachments/
+          # The attachments dir is a dot-directory; without this the action
+          # silently uploads nothing ("No files were found").
+          include-hidden-files: true
           retention-days: 7
 
   merge-reports:

.github/workflows/fresh-install-tests.yml

@@ -82,6 +82,9 @@ jobs:
         name: Build packages
         run: vp run -r build
 
+      - name: Install PDF tooling (veraPDF conformance gate + poppler visual snapshots)
+        run: bash tests/scripts/install-pdf-tooling.sh
+
       - id: run_unit_tests
         name: Run unit tests
         run: vp run test

.github/workflows/update-e2e-screenshots.yml

@@ -0,0 +1,67 @@
+# Regenerates the Linux screenshot baselines for the browser (e2e) suite in
+# the same Playwright container the e2e jobs use, and uploads them as an
+# artifact to download and commit. Linux baselines can otherwise only be
+# produced locally through docker; this is the push-button alternative.
+name: Update e2e screenshots
+
+on:
+  workflow_dispatch:
+    inputs:
+      filter:
+        description: "Test file filter (empty = all browser tests)"
+        required: false
+        default: "exporterImages"
+  # workflow_dispatch only works once the file is on the default branch;
+  # until then, touching this file re-triggers a run on the feature branch.
+  push:
+    paths:
+      - ".github/workflows/update-e2e-screenshots.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  update-screenshots:
+    name: "Update screenshots"
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    container:
+      image: mcr.microsoft.com/playwright:v1.60.0-noble
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 100
+          persist-credentials: false
+
+      - uses: voidzero-dev/setup-vp@313600b80b104eadebb9111787d37a2e83e014ca # v1.17.0
+        with:
+          node-version-file: ".node-version"
+          cache: true
+
+      - name: Install dependencies
+        run: vp install
+
+      # `-u` must come after the filter, and each browser runs separately so a
+      # failure in one doesn't stop the others' baselines from updating.
+      - name: Update screenshots (chromium)
+        run: HOME=/root vp test -c vite.config.browser.ts --run --browser chromium ${{ inputs.filter || 'exporterImages' }} -u
+        working-directory: tests
+        continue-on-error: true
+      - name: Update screenshots (firefox)
+        run: HOME=/root vp test -c vite.config.browser.ts --run --browser firefox ${{ inputs.filter || 'exporterImages' }} -u
+        working-directory: tests
+        continue-on-error: true
+      - name: Update screenshots (webkit)
+        run: HOME=/root vp test -c vite.config.browser.ts --run --browser webkit ${{ inputs.filter || 'exporterImages' }} -u
+        working-directory: tests
+        continue-on-error: true
+
+      - name: Show changed baselines
+        run: git config --global --add safe.directory "$GITHUB_WORKSPACE" && git status --porcelain tests/src
+
+      - name: Upload updated screenshots
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: updated-screenshots
+          path: tests/src/**/__screenshots__/
+          retention-days: 7

docs/AGENTS.md

@@ -0,0 +1,9 @@
+<!-- BEGIN:nextjs-agent-rules -->
+
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.
+
+This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.
+
+<!-- END:nextjs-agent-rules -->

docs/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

docs/app/demo/_components/DemoEditor.tsx

@@ -44,10 +44,12 @@ import {
   ODTExporter,
   odtDefaultSchemaMappings,
 } from "@blocknote/xl-odt-exporter";
+// The deprecated react-pdf exporter; the demo's PDF action migrates to the
+// Typst-based PDFExporter with the examples/docs pass for the new API.
 import {
   PDFExporter,
   pdfDefaultSchemaMappings,
-} from "@blocknote/xl-pdf-exporter";
+} from "@blocknote/xl-pdf-exporter/react-pdf";
 import { pdf } from "@react-pdf/renderer";
 import { DefaultChatTransport } from "ai";
 import { useTheme } from "next-themes";

docs/components/typstCompilerWasmUrl.ts

@@ -0,0 +1,11 @@
+// The Typst compiler wasm for the docs build (see next.config.ts): the
+// pdf-ua example bundles it via Vite's `?url`; under the docs site the
+// import is aliased here. `new URL(..., import.meta.url)` is Turbopack's
+// static-asset reference: the ~29MB wasm is emitted as a hashed static
+// file and served by the site itself - no CDN involved, and the version
+// can't skew from the installed package because it IS the installed file.
+const url = new URL(
+  "../node_modules/@myriaddreamin/typst-ts-web-compiler/pkg/typst_ts_web_compiler_bg.wasm",
+  import.meta.url,
+).href;
+export default url;

docs/components/typstRendererStub.ts

@@ -0,0 +1,4 @@
+// Stub for @myriaddreamin/typst-ts-renderer (see next.config.ts): the
+// pdf-ua demo only compiles Typst, never canvas-renders, so the optional
+// renderer peer is not installed.
+export {};

docs/content/docs/features/blocks/diagrams.mdx

@@ -68,15 +68,16 @@ The example below wires them all up.
 
 Diagrams export to every format BlockNote supports. [Markdown](/docs/features/export/markdown) works out of the box — diagrams export as ` ```mermaid ` fenced code blocks, their common Markdown notation.
 
-The [PDF](/docs/features/export/pdf), [DOCX](/docs/features/export/docx), [ODT](/docs/features/export/odt), and [email](/docs/features/export/email) exporters embed the diagram as an image via their mappings — they live as subpaths of this package, and each exports a `createDiagramBlockMapping` factory to spread into the exporter's default mappings. The [DOCX exporter](/docs/features/export/docx) shown here; the [PDF](/docs/features/export/pdf), [ODT](/docs/features/export/odt), and [email](/docs/features/export/email) exporters work the same way with their respective subpaths:
+The [PDF](/docs/features/export/pdf) (and [Typst](/docs/features/export/typst)), [DOCX](/docs/features/export/docx), [ODT](/docs/features/export/odt), and [email](/docs/features/export/email) exporters embed the diagram as an image via their mappings — they live as subpaths of this package, and each exports a `createDiagramBlockMapping` factory to spread into the exporter's default mappings. The [DOCX exporter](/docs/features/export/docx) shown here; the others work the same way with their respective subpaths:
 
 ```typescript
 import {
   DOCXExporter,
   docxDefaultSchemaMappings,
 } from "@blocknote/xl-docx-exporter";
 import { createDiagramBlockMapping } from "@blocknote/diagram-block/docx-exporter";
-// ...or "@blocknote/diagram-block/pdf-exporter",
+// ...or "@blocknote/diagram-block/typst-exporter" (PDF + Typst - embeds
+//       vector SVG with labels as real text),
 //       "@blocknote/diagram-block/odt-exporter",
 //       "@blocknote/diagram-block/email-exporter"
 

docs/content/docs/features/blocks/math.mdx

@@ -121,34 +121,29 @@ import {
 
 ### PDF
 
-With the [PDF exporter](/docs/features/export/pdf), math blocks export as vector formulas — no rasterization, so they also work server-side out of the box. Inline math is rasterized to images that flow with the text:
+With the [PDF exporter](/docs/features/export/pdf) (or the standalone
+[Typst exporter](/docs/features/export/typst) — they share mappings), math
+blocks and inline math export as **native Typst equations**: real, selectable
+text, no rasterization, so they also work server-side out of the box:
 
 ```typescript
 import {
-  createInlineMathMapping,
+  inlineMathMapping,
   mathBlockMapping,
-} from "@blocknote/math-block/pdf-exporter";
+} from "@blocknote/math-block/typst-exporter";
 
-// Spread into the PDFExporter's mappings as for DOCX above - note that
-// inline math is a factory here: `math: createInlineMathMapping()`.
+// Spread into the PDFExporter's mappings as for DOCX above:
+// `mathBlock: mathBlockMapping` and `math: inlineMathMapping`.
 ```
 
-The inline math factory takes one option:
-
-```typescript
-createInlineMathMapping(options?: {
-  /**
-   * Rasterizes the formula SVG to an image. Defaults to the built-in
-   * canvas rasterizer, which only works in the browser - when exporting
-   * server-side, pass one backed by e.g. `@resvg/resvg-js` or `sharp`;
-   * without it, a server-side export throws. The `RasterizeSVG` type is
-   * exported from the same subpath.
-   */
-  rasterize?: RasterizeSVG;
-});
-```
+The LaTeX is converted to Typst's math notation. Most KaTeX commands are
+covered; a valid formula using an uncovered command fails the export loudly
+(rather than silently exporting something else), while invalid LaTeX renders
+the error placeholder as in other formats.
 
-Math blocks require the `@react-pdf/math` package (a peer dependency of the PDF mapping).
+The deprecated [react-pdf exporter](/docs/features/export/pdf#deprecated-the-react-pdf-exporter)'s
+mappings remain available from `@blocknote/math-block/pdf-exporter` during its
+deprecation window.
 
 ### Email
 

docs/content/docs/features/export/meta.json

@@ -1,4 +1,4 @@
 {
   "title": "Export",
-  "pages": ["markdown", "html", "pdf", "docx", "email", "odt", "..."]
+  "pages": ["markdown", "html", "pdf", "docx", "email", "odt", "typst", "..."]
 }