• Wait for back-before-hydration recoveries in the browser: #97321
• Extract metadata resolution primitives: #97388
• test: update React 18 redbox snapshot: #97415
• Turbopack: retain conditions when replacing resolve request keys: #97372
• Remove server route matcher stack: #94157

Huge thanks to @gaearon, @gnoff, @timneutkens, and @mischnic for helping!

I am pleased to announce the release of officeParser v7.6.2! This patch closes four Markdown/HTML round-trip fidelity bugs found while driving a real editor's save → load → save cycle through officeParser: a single-line code block losing its language, inline code losing its backticks, a raw <br> being escaped, and a table header emitting invalid HTML. Each was a case where officeParser's own output did not reparse into what produced it; all four now round-trip cleanly.

These are corrections, not new behavior to guard against: the only output that moves is content that was previously lost, escaped, or emitted as invalid markup, so upgrading fixes those cases rather than disturbing working ones. If you built a workaround for any of them, you can drop it.

MarkdownGenerator chose fenced-vs-inline purely by whether the code text contained a newline, ignoring the language, so a one-line code block (const x = 1; tagged js) or a one-line mermaid diagram collapsed to an inline `code` span. That silently dropped both the language and its block-ness, and re-imported as an inline code mark rather than a code block. A code node is always block-level (genuinely inline code is a monospace text node), so a code node with a language now always emits as a fenced block regardless of newlines. A tagged `const x = 1;` becomes a proper js block again.

Inline code parses to a monospace text node, but the generator's text-node path had no backtick emission for it, so every inline `code` (and inline <code> from HTML) degraded to plain text on md → md and html → md. Monospace text is now re-wrapped in backticks, fence-sized so an embedded backtick can't close the span early, with emphasis wrapping the span so **`code`** round-trips.

MarkdownGenerator emits a raw <br> for a line break inside a table cell (a GFM pipe cell cannot hold a newline), but MarkdownParser did not read it back. It escaped <br> to <br>, destroying the break on the md → html hop, in cells and paragraphs alike. The parser now recognises <br> / <br/> / <br /> as a hard line break, symmetric with what the generator writes, so a <br> survives the round trip. A table-cell line break, ubiquitous in Word-imported forms and exams, is now preserved.

generate('html') emitted a table's header cells directly under <thead> (<thead><th>…) with no wrapping <tr>, which is invalid HTML that officeParser's own HtmlParser could not read back as a table, so a md → HTML → md round trip lost the header (its cells came back empty). The header row is now wrapped in a <tr> (<thead><tr><th>…), which is valid and self-idempotent.

• Heading anchors are already toggleable. generate('md') appends a kramdown/Pandoc {#slug} suffix to headings (# Title {#title}), which GFM/CommonMark render as literal text. The existing top-level generateIds: false omits it (and the HTML heading ids). It is a generator-wide option, not under mdConfig, which made it easy to miss. Now documented in the README.

npm install officeparser@7.6.2

🔗 Full Changelog: View v7.6.2 details 🔗 Documentation & Visualizer: officeparser.harshankur.com

• #749 by @bobsingor – open({ kind: 'share' }): the engine resolves public share tokens itself.
  • The share arm exchanges shr_… for a session JWT on the engine's own transport (baseUrl + configured fetch) and delegates to the token arm, so the handle binds to a self-renewing source — revoking or editing the share retargets the open at the next renewal. Works on an engine constructed with no engine-level token at all.
  • Exchange failures surface as EngineErrors — on open() and on every later renewal (RPCs, SSE reconnects) — never as raw ShareExchangeErrors. Protected grants reject with the new EngineErrorCode.SharePasswordRequired; the wire code and HTTP status ride in details, the original error in cause. The mapping is exported as engineErrorFromShareExchange.
  • shareSessionSource now declares its concrete return type (() => Promise<string>) instead of the TokenSource union; HttpClient exposes baseUrl and fetchImpl getters.

• #749 by @bobsingor – Share sources pass through to the engine; the viewer-only share vocabulary is retired.
  • { kind: 'share' } is a standard OpenInput kind now, resolved by engine.open() itself — resolveCloudConfig no longer lowers share entries into token sources, and no longer re-threads baseUrl/fetch into the exchange.
  • BREAKING (prerelease line): on share sources the grant passphrase field is sharePassword (was password, which now means the PDF's own encryption password — the same slot every other kind uses). The top-level shareToken/sharePassword shorthands are unchanged.
  • CloudShareSource and CloudInitialDocument remain as deprecated aliases of OpenInputShare and InitialDocument.

• #755 by @bobsingor – Model carets anchored to rotated text as oriented box geometry.

  • Add caretGeomFromAnchor, which places the caret at the trailing glyph edge and derives its authoring rotation from the text baseline while preserving the previous byte-identical upright geometry.
  • Carry optional rotation on caret geometry, apply it to local-frame hit testing, and expose an oriented selection outline without enabling caret rotate or resize gestures.

• #755 by @bobsingor – Models text-markup annotations with semantic text quads and adds oriented caret anchors, allowing highlight, underline, strikeout, squiggly, caret, and replace-text geometry to follow the selected text frame.

• #755 by @bobsingor – Adds semantic TextQuad geometry with corner-named transforms, bounds, rectangle conversion, positional PDF quad conversion, and resilient normalization for imported /QuadPoints.

• #755 by @bobsingor – Add the canonical affine-aware text layout engine under text/layout: buildPageTextLayout, textGlyphAt, expandTextRangeToWord/Line, textGlyphQuad, and textSegmentsForRange, producing PdfTextSegment { quad, rect, advance }.

  Orientation frames are derived from the semantic edges of glyph quads and keyed by baseline direction and ascent handedness. Rotated and mirrored text become upright inside their frame, while shear remains an in-frame variation so mixed roman and italic text stays in one segment. Every run in a cluster uses the same canonical frame, and upright documents retain a byte-identical fast path.

• #755 by @bobsingor – Extend the caret annotation contract with box-family rotation metadata.

  Caret DTOs, drafts, patches, and schemas now carry optional rotation and unrotatedRect fields with the same tri-state semantics as other box-family annotations. Rotation-stripped appearance documentation now includes carets.

• #749 by @bobsingor – Adds share to the OpenInput union and a SharePasswordRequired engine error code.

  • OpenInputShare ({ kind: 'share', shareToken, sharePassword?, password? }) is the third cloud reference form, alongside id and token: a public share token from the dashboard's embed snippet, resolved by the cloud engine itself. Rejected by @embedpdf/engine, like the other cloud kinds.
  • sharePassword is the grant's passphrase (checked at exchange); password stays the PDF's own encryption password, same slot as every other kind.
  • EngineErrorCode.SharePasswordRequired is the prompt-and-retry signal for protected grants — the share sibling of DocPasswordRequired.

• #755 by @bobsingor – Extends page geometry snapshots with an upright/rotated run union, oriented glyph cells, rotation and ascent-flip metadata, uniform quad and bounds helpers, wire schemas, and orientation conformance coverage.

• #755 by @bobsingor – Returns orientation-aware page text geometry from the local engine so consumers can select and annotate rotated, sheared, and mirrored text without collapsing glyph cells into axis-aligned boxes.

• #751 by @bobsingor – Export the shared document types (OpenInput, OpenOptions, DocumentHandle, PageHandle, DocumentCapabilities, TokenSource, …) from the package root, mirroring @cloudpdf/engine, so code driving the engine directly can name them without importing from the transitive @embedpdf/engine-core dependency.

• #755 by @bobsingor – Generate rotated caret appearances in the EmbedPDF PDFium runtime.

  The caret appearance generator now consumes the shared rotation metadata pair, draws in the logical unrotated box, and emits the form transform needed for the baked caret to follow its text baseline.

• #755 by @bobsingor – Updates the EmbedPDF PDFium runtime with oriented per-character geometry and orientation-aware text-markup appearance generation for rotated, sheared, and mirrored text, while retaining safe fallbacks for malformed quads.

• #755 by @bobsingor – Replace the parallel rects[] and quads[] geometry on SearchMatch with canonical segments: PdfTextSegment[], validated by PdfTextSegmentSchema.

  Search tokens now always encode format=segments1, preventing newer clients from consuming stale CDN-cached responses with the old geometry shape; old tokens fail decoding instead.

• #755 by @bobsingor – Persist and render caret rotation through the engine annotation services.

  • Read and write the caret rotation and unrotatedRect metadata pair during create, patch, and list operations.
  • Treat caret subtype 14 as box-family when rendering annotation appearances, returning a rotation-stripped raster placed by the logical box so consumers do not double-rotate it after reload.

• #755 by @bobsingor – Reads boxes, oriented cells, flags, and text orientation through the new runtime geometry call, preserving the compact upright wire shape while emitting rotated runs for non-upright glyphs. Native page-redaction failures are now reported instead of being mistaken for pages without redaction annotations.

• #755 by @bobsingor – Render search and selection highlights from canonical text segments. Axis-aligned lines retain their classic appearance, while rotated lines render their true oriented cells.

• #755 by @bobsingor – Render live caret annotations with their text-baseline rotation.

  The React annotation painter now treats caret SVGs as box-family visuals, applying the caret's authoring rotation about its centre while continuing to leave vertex-geometry rotation advisory.

• #755 by @bobsingor – Renders text-selection highlights from oriented segment polygons so the React selection layer follows rotated, sheared, and mirrored text.

• #755 by @bobsingor – Round-trip rotated caret geometry through the annotation repository.

  Rotated carets now lower their logical box and content-space tilt into /Rect, rotation, and unrotatedRect, and reconstruct that geometry when engine annotations are ingested. Upright writes explicitly clear stale transform metadata.

• #755 by @bobsingor – Creates, previews, imports, and persists text-markup annotations with oriented quads and places caret and replace-text annotations at the selected glyph's trailing edge.

• #755 by @bobsingor – Represent search-hit geometry as canonical segments: TextSegment[] with a precomputed bounds envelope. Search reveal now passes that envelope directly to stage.reveal(hit.pageIndex, { rect: hit.bounds }) instead of manually folding rectangles.

• #755 by @bobsingor – Use the engine's canonical text segmentation while keeping selection gestures and state in the plugin coordinate seam.

  SelectionSnapshot.pages now carries segments only, with boxes exposed as derived views through segment.rect and rectsForPage(). Public geometry exports are now buildSelectionPageGeometry, contentPointToPdf, toContentSegment, and toContentTextQuad.

• #755 by @bobsingor – Builds selections as oriented line segments, exposes their semantic quads and reading direction, and anchors selection endpoints to glyph cells while retaining AABB access for scrolling and conservative regions.

• #750 by @bobsingor – Preserves configured CORS response headers on the hijacked server-sent events stream, allowing browser clients on permitted origins to subscribe to document layer events.

• #755 by @bobsingor – Preserves oriented selection quads through text-redaction marks, previews, and native apply so rotated, sheared, and mirrored text can be redacted without expanding the mark to its axis-aligned bounds.

• #5098 by @NoiceHax – Fix editor.api.html.deserialize returning unwrapped text nodes at the root for inline-only HTML

• Updated @platejs/core.

• Updated @platejs/core, @platejs/utils.

Thanks to everyone who contributed to this release:

@NoiceHax

Full changelog: v53.3.5...v53.3.6

• @docx-editor.dev/i18n@2.4.1

• 32018ce: Document and test explicit byte ownership for detached server runtimes: createServer completes consumption of input bytes and each save returns fresh caller-owned bytes.
  • @docx-editor.dev/core@2.4.1

• @docx-editor.dev/i18n@2.4.1