🔄 Sync stable → main#3762
Closed
superdoc-bot[bot] wants to merge 47 commits into
Closed
Conversation
…6-06-12 Merge main into stable
Based on the commit messages, here are the release notes: ### What's New - **Textbox editing** — Edit text content inside VML and DrawingML textboxes with full interaction support; clicks map to content positions. - **Font family combobox** — Browse and select fonts directly from the toolbar. - **Font size options** — UI API exposes font size choices for custom toolbars. - **Comments API expansion** — `ui.comments.setActive()` highlights a comment without scrolling; pending-comments-update event carries `pendingSelection`. - **Viewport scroll container** — `ui.viewport.getScrollContainer()` returns the editor's resolved scroll element. - **Text range viewport geometry** — `ui.viewport.getRect()` now accepts Document API text addresses and targets. - **Sidebar viewport observation** — `ui.viewport.observe` fires when comments rail opens or closes. - **Zoom modes** — Manual and fit-width zoom with observable transitions, viewport metrics, `useSuperDocZoom` React hook, and toolbar command. - **Table of contents hover** — Hovering TOC entries highlights corresponding sections. ### Improvements - **Multi-column section balancing** — Continuous sections balance correctly with explicit per-column widths preserved throughout layout. - **Column spacing precision** — Per-column gaps drive separator positions per ECMA-376; unequal-width columns honor per-column `w:space`. - **Font substitutes** — Metric-compatible fallbacks load for Calibri, Cambria, Arial, Times New Roman, and Courier New before measurement. - **Tracked table changes** — Inline cell edits consolidate into single review items instead of separate entries. ### Fixes - Paragraphs with pageBreakBefore style no longer add blank pages when directly following explicit page breaks. - Textbox text alignment matches Word when tables are inside textboxes. - Table cell selection highlights appear over empty space; multiline selection interior lines render at full width. - Plan engine recovers from stale block identities on recompile without crashes. - Tab carets anchor to line top instead of bottom; soft-break continuation carets position alignment-aware at line start. - DOCX export preserves generated line breaks as `<w:br/>` elements instead of raw newlines. - Font toolbar no longer races on editor handoff; combobox selection flow handles edge cases. - Viewport geometry invalidates on sidebar toggle without px-level jitter. - Zoom state — PDF documents contribute to viewport metrics; mode-only transitions emit correctly. - TOC anchor navigation preserves bookmark start/end order. - Image alpha modifiers process correctly on import and export. - Font picker keyboard behavior consistent across selection modes. - Formatting preserved when typing text over toolbar font selections.
### What's New - **Textbox editing** — Edit text content inside VML and DrawingML textboxes; clicks map to content positions with full interaction support. - **Font family combobox** — Browse and select fonts directly from the toolbar. - **Font size options** — UI API exposes font size choices for custom toolbars. - **Comments API: activate-only highlight** — `ui.comments.setActive()` marks a comment active without scrolling. - **Pending selection on comments event** — `pending-comments-update` event carries `pendingSelection` captured before the live selection clears. - **Scroll container getter** — `ui.viewport.getScrollContainer()` returns the editor's resolved scroll element for overlay consumers. - **Text range viewport geometry** — `ui.viewport.getRect()` accepts Document API text addresses and targets, not just entities. - **Sidebar viewport observation** — `ui.viewport.observe` fires when the comments rail opens or closes. - **Zoom modes** — Manual and fit-width zoom with observable mode transitions, viewport metrics, `useSuperDocZoom` React hook, and toolbar command. - **Table of contents hover** — Hovering TOC entries highlights corresponding sections in the document. ### Improvements - **Multi-column section balancing** — Continuous sections balance correctly with explicit per-column widths preserved throughout layout. - **Column spacing precision** — Per-column gaps drive separator positions per ECMA-376; unequal-width columns honor per-column `w:space`. - **Font substitutes** — Metric-compatible fallbacks load for Calibri, Cambria, Arial, Times New Roman, and Courier New before measurement; no reflow. - **Tracked table changes** — Inline cell edits consolidate into single review items instead of separate entries. ### Fixes - Paragraphs with `pageBreakBefore` style no longer add blank pages when directly following explicit page breaks. - Textbox text alignment now matches Word when tables are inside textboxes. - Table cell selection highlights appear over empty space; multiline selection interior lines render at full width. - Plan engine recovers from stale block identities on recompile without crashes. - Tab carets anchor to line top instead of bottom; soft-break continuation carets position alignment-aware at line start. - DOCX export preserves generated line breaks as `<w:br/>` elements instead of raw newlines. - Font toolbar no longer races on editor handoff; combobox selection flow handles edge cases. - Viewport geometry invalidates on sidebar toggle without px-level jitter. - Zoom state — PDF documents contribute to viewport metrics; mode-only transitions emit correctly. - TOC anchor navigation preserves bookmark start/end order. - Image alpha modifiers process correctly on import and export. - Font picker keyboard behavior consistent across selection modes. - Formatting preserved when typing text over toolbar font selections.
### What's New - **Textbox editing** — Click, type, and select text directly inside VML and DrawingML textboxes; full caret and selection support. - **Font family combobox** — Browse and select fonts from the toolbar; font selection flows through custom UI. - **Font size API** — `ui.viewport` exposes available font sizes for custom toolbars and programmatic queries. - **Comments API: activate-only highlight** — `ui.comments.setActive()` marks a comment active without scrolling or moving selection. - **Pending selection on comment events** — `pending-comments-update` event carries `pendingSelection` captured before the live DOM selection clears. - **Scroll container access** — `ui.viewport.getScrollContainer()` returns the editor's resolved scroll element for overlay consumers. - **Text range viewport geometry** — `ui.viewport.getRect()` now accepts Document API text addresses and targets, not just entities. - **Sidebar viewport observation** — `ui.viewport.observe` fires when the comments rail opens or closes. - **Zoom modes** — Manual and fit-width zoom modes with observable transitions, viewport metrics, `useSuperDocZoom` React hook, and toolbar command. - **Table of contents hover** — Hovering TOC entries highlights corresponding document sections. ### Improvements - **Multi-column section balancing** — Continuous sections now balance correctly; explicit per-column widths preserved throughout layout. - **Column spacing precision** — Per-column gaps drive separator positions per ECMA-376; unequal-width columns honor per-column `w:space` values. - **Font substitutes load before measurement** — Metric-compatible fallbacks for Calibri, Cambria, Arial, Times New Roman, and Courier New load upfront; no reflow. - **Tracked table changes consolidation** — Inline cell edits fold into a single review item instead of separate entries; one decision applies to the whole table. ### Fixes - Paragraphs styled with `pageBreakBefore` no longer insert blank pages when directly following explicit page breaks. - Textbox text alignment now matches Word behavior when tables are nested inside textboxes. - Table cell selection highlights render over empty space; multiline selections show full-width interior lines. - Plan engine recovers from stale block identities on recompile without crashes. - Tab carets anchor to line top (not bottom); soft-break continuation carets position at line start with alignment-aware offset. - DOCX export preserves generated line breaks as `<w:br/>` elements instead of raw newlines. - Font toolbar no longer races on editor handoff; combobox selection handles edge cases correctly. - Viewport geometry invalidates on sidebar toggle without pixel-level jitter. - Zoom state — PDF documents contribute to viewport metrics; mode-only transitions emit correctly. - TOC anchor navigation preserves `bookmarkStart`/`bookmarkEnd` order. - Image alpha modifiers process correctly on import and export. - Font picker keyboard behavior consistent across selection modes. - Formatting is preserved when typing text over a toolbar font selection.
Now I have enough context. Let me write the release notes based on the actual changes: ### What's New - **Textbox content editing** — Click, type, and edit text inside VML and DrawingML textboxes. Selection, caret rendering, and text updates work across body, header/footer, and table cell contexts. - **Zoom modes and fit-width** — Set zoom as `manual` or `fit-width` (auto-fit to container). `ui.zoom` exposes mode, value, calculated fit-zoom, bounds, and viewport metrics; PDF documents measure at their rendered scale. - **Viewport metrics and responsive layout events** — `viewport-change` event fires on container resize with measurements (document width, available width, fit-zoom). Consume viewport metrics from `getViewportMetrics()` to implement responsive zoom without polling. - **Font family combobox** — Typeahead-enabled font picker in toolbar with per-document font options and substitution evidence (metric-safe vs. visual-only); dropdown stays in viewport. - **Comments API expansion** — `ui.comments.setActive()` highlights a comment without scrolling; `pendingSelection` on pending comment events gives consumers the captured selection to pass to comment creation APIs. - **Text range viewport targets** — `ui.viewport.getRect()` now accepts Document API text targets (addresses and segments), resolving to painted DOM rects for custom overlay and floating-UI anchoring. - **Scroll container exposure** — `ui.viewport.getScrollContainer()` returns the actual scrollable ancestor (or null for document/window scroll), letting overlay consumers attach scroll listeners to the right element. - **Sidebar geometry signals** — `ui.viewport.observe` fires when the comments rail opens/closes, invalidating cached viewport geometry. - **TOC interactions** — Hover highlighting and section-link navigation for table of contents. ### Improvements - **Column balancing at continuous breaks** — Multi-column sections now balance correctly at continuous section breaks, matching Word's layout. Explicit column widths (equal or unequal) and per-column spacing extract accurately. - **Tracked change granularity** — Inline cell changes within a whole-table tracked change consolidate into one logical change in the review API (groupTrackedChanges), mirroring the comments containment rule. - **Line break handling in mutations** — Generated newlines in text-mode mutations serialize as Word-native `<w:br/>` elements; read model treats lineBreak nodes as `\n` so search/query/rewrite stay consistent. - **Caret geometry for tabs and soft breaks** — Tab carets anchor to line top; soft-break continuation carets position at line start with alignment-aware offset instead of the page right edge. - **Page break suppression** — Style-driven pageBreakBefore directly after an explicit page break no longer renders a redundant blank page, matching Word's structural rule. - **Textbox table content rendering** — Tables inside textboxes render with correct alignment and text flow. - **Plan-engine block identity repair** — Runtime self-healing of duplicate block identities on compile, preventing stale cross-document references. - **Font substitution evidence** — Font reports carry per-face evidence (metric-safe, visual-only, glyph exceptions) from the docfonts registry, giving consumers the fidelity detail behind each substitution. ### Fixes - **Table cell selection collapse** — Dragging a body selection into an empty table cell no longer collapses the selection; prosemirror-tables normalization guard keeps the extended range. - **Multiline selection rendering** — Interior lines of multi-line selections now render the full width highlight instead of slivers; per-line rect computation handles absolutely-positioned `.superdoc-line` elements across browsers. - **Empty cell geometry** — Empty table cell paragraphs (no runs) resolve to their PM start instead of null, preventing frozen selections during active drags. - **Image alpha export** — Process alphaModFix for images on export, preserving transparency properties. - **Text selection in generated lineBreak contexts** — Search and offset resolution now treat lineBreak nodes as `\n`, so a match spanning text+lineBreak+text coalesces to one contiguous range. - **Font toolbar updates** — Document font toolbar rebuilds and layout re-renders on fonts-changed events; dropdown state persists through editor handoff. - **UV-deprecated legacy visual testing infrastructure** — Removed `/devtools/visual-testing`; layout validation now runs in the standard test suite.
### What's New - **Textbox content editing** — Click to edit text inside textboxes in body, headers, footers, and table cells with full selection and caret support. - **Zoom modes and fit-width** — Choose zoom mode (`manual` or `fit-width` for auto-fit) and read state, calculations, bounds, and viewport metrics from `ui.zoom`. - **Viewport change events** — Listen for `viewport-change` when the container resizes to receive document width, available width, and calculated fit-zoom. - **Font family combobox** — Search for fonts in the toolbar by name and see per-document options with substitution evidence. - **Comments activation API** — Highlight comments without scrolling using `ui.comments.setActive()`, and access the captured selection from pending comment events. - **Text range viewport rects** — Pass Document API text targets to `ui.viewport.getRect()` to get painted rects for overlay positioning. - **Scroll container access** — Call `ui.viewport.getScrollContainer()` to find the element that actually scrolls, or null for window scroll. - **Sidebar geometry updates** — `ui.viewport.observe` fires when the comments rail opens or closes. - **TOC interactions** — Hover highlights sections in the table of contents, and click navigates to them. ### Improvements - **Column balancing** — Multi-column sections balance at continuous section breaks, matching Word's behavior. - **Grouped tracked changes** — Inline cell changes inside a whole-table tracked change now group as one review item. - **Line break serialization** — Newlines in text mutations serialize as `<w:br/>` and round-trip without loss. - **Tab and soft-break carets** — Tab carets anchor to line top, and soft-break carets position at line start with alignment awareness. - **Page break suppression** — Removed blank pages when `pageBreakBefore` appears directly after an explicit page break. - **Textbox table rendering** — Tables inside textboxes render with correct alignment and text flow. - **Block identity repair** — Duplicate block identities fix automatically on compile. - **Font substitution evidence** — Font reports carry per-face evidence (metric-safe, visual-only, glyph exceptions). ### Fixes - **Empty table cell selection** — Dragging a selection into an empty cell no longer collapses. - **Multiline selection rendering** — Interior lines of multi-line selections render full-width highlights. - **Empty cell geometry** — Empty cell paragraphs resolve to a valid position for interaction. - **Image alpha on export** — Images with transparency now preserve alpha on DOCX export. - **Linebreak text selection** — Search spans and selections spanning text+linebreak+text now coalesce correctly. - **Font toolbar updates** — Toolbar rebuilds when document fonts change or editor switches.
### What's New - **Textbox content editing** — Click, type, and edit text inside VML and DrawingML textboxes. Selection, caret rendering, and text updates work across body, header/footer, and table cell contexts. - **Zoom modes and fit-width** — Set zoom as `manual` or `fit-width` (auto-fit to container). `ui.zoom` exposes mode, value, calculated fit-zoom, bounds, and viewport metrics; PDF documents measure at their rendered scale. - **Viewport metrics and responsive layout events** — `viewport-change` event fires on container resize with measurements (document width, available width, fit-zoom). Consume viewport metrics from `getViewportMetrics()` to implement responsive zoom without polling. - **Font family combobox** — Typeahead-enabled font picker in toolbar with per-document font options and substitution evidence (metric-safe vs. visual-only); dropdown stays in viewport. - **Comments API expansion** — `ui.comments.setActive()` highlights a comment without scrolling; `pendingSelection` on pending comment events gives consumers the captured selection to pass to comment creation APIs. - **Text range viewport targets** — `ui.viewport.getRect()` now accepts Document API text targets (addresses and segments), resolving to painted DOM rects for custom overlay and floating-UI anchoring. - **Scroll container exposure** — `ui.viewport.getScrollContainer()` returns the actual scrollable ancestor (or null for document/window scroll), letting overlay consumers attach scroll listeners to the right element. - **Sidebar geometry signals** — `ui.viewport.observe` fires when the comments rail opens/closes, invalidating cached viewport geometry. - **Table of contents interactions** — Hover highlighting and section-link navigation for table of contents. ### Improvements - **Column balancing at continuous breaks** — Multi-column sections now balance correctly at continuous section breaks, matching Word's layout. Explicit column widths (equal or unequal) and per-column spacing extract accurately. - **Tracked change granularity** — Inline cell changes within a whole-table tracked change consolidate into one logical change in the review API, mirroring the comments containment rule. - **Line break handling in mutations** — Generated newlines in text-mode mutations serialize as Word-native `<w:br/>` elements; read model treats lineBreak nodes as `\n` so search/query/rewrite stay consistent. - **Caret geometry for tabs and soft breaks** — Tab carets anchor to line top; soft-break continuation carets position at line start with alignment-aware offset instead of the page right edge. - **Page break suppression** — Style-driven pageBreakBefore directly after an explicit page break no longer renders a redundant blank page, matching Word's structural rule. - **Textbox table content rendering** — Tables inside textboxes render with correct alignment and text flow. - **Plan-engine block identity repair** — Runtime self-healing of duplicate block identities on compile, preventing stale cross-document references. - **Font substitution evidence** — Font reports carry per-face evidence (metric-safe, visual-only, glyph exceptions) from the docfonts registry, giving consumers the fidelity detail behind each substitution. ### Fixes - **Table cell selection collapse** — Dragging a body selection into an empty table cell no longer collapses the selection; prosemirror-tables normalization guard keeps the extended range. - **Multiline selection rendering** — Interior lines of multi-line selections now render the full width highlight instead of slivers; per-line rect computation handles absolutely-positioned `.superdoc-line` elements across browsers. - **Empty cell geometry** — Empty table cell paragraphs (no runs) resolve to their ProseMirror start instead of null, preventing frozen selections during active drags. - **Image alpha export** — Process alphaModFix for images on export, preserving transparency properties. - **Text selection in generated lineBreak contexts** — Search and offset resolution now treat lineBreak nodes as `\n`, so a match spanning text+lineBreak+text coalesces to one contiguous range. - **Font toolbar updates** — Document font toolbar rebuilds and layout re-renders on fonts-changed events; dropdown state persists through editor handoff.
Based on my analysis of the commits and changes, here are the release notes: ### Fixes - **Page breaks** — Removed redundant blank pages when a paragraph with pageBreakBefore style follows an explicit page break. Word's rule is structural, not geometric; we now match that behavior exactly. - **Table cell selection** — Fixed selection highlight disappearing over empty space inside table cells. Also fixed multiline selection rendering and empty cell hit detection. - **Textbox rendering** — Corrected rendering and text alignment for textboxes containing tables. - **Image alpha transparency** — Process `alphaModFix` attributes correctly during import and export to preserve image transparency settings. - **Block identity repair** — Runtime self-healing for duplicate block identities on compile, preventing stale references from breaking document operations. ### What's New - **Textbox editing** — Phase 0 and 1 of textbox content editing. Render and edit VML and DrawingML textbox content. Full support for textboxes in headers, footers, and table cells with proper position preservation through import/export. ### Improvements - **Font system** — Bundle docfonts 0.15 and 0.16 with expanded census rows and legal-cleared fallback fonts for better coverage. - **Documentation** — Updated examples for custom UI APIs and clarified viewport geometry behavior.
…6-06-12 Merge main into stable
Based on my analysis of the commits, v0.17.1 contains a single fix: rolling back the default toolbar font options to a conservative baseline. ### Fixes - **Toolbar fonts** — Reverted default font dropdown to the conservative baseline (Arial, Courier New, Georgia, Times New Roman). Per-document font options remain available through the font selector.
### Fixes - **Default toolbar fonts** — Rolled back font dropdown to a conservative baseline (Arial, Courier New, Georgia, Times New Roman). Per-document font options remain available through the font selector.
Based on my analysis of the git diff, this patch release contains a single fix related to the toolbar font dropdown. Here are the release notes: ### Fixes - **Toolbar fonts** — Rolled back font dropdown to conservative baseline (Arial, Courier New, Georgia, Times New Roman). Per-document font options remain available through the font selector.
### Fixes - Toolbar font dropdown reverted to a conservative baseline (Arial, Courier New, Georgia, Times New Roman) while the optional font-pack selection UI is finalized. Full font resolution through documents remains unchanged.
### Fixes - Toolbar font dropdown returns to a conservative baseline (Arial, Courier New, Georgia, Times New Roman) while the optional font-pack selection UI is finalized — full font resolution within documents remains unchanged.
### Fixes - Toolbar font dropdown reverted to a conservative baseline (Arial, Courier New, Georgia, Times New Roman) while the optional font-pack selection UI is finalized. Document rendering of all fonts remains unchanged.
### What's New
- **Bundled fonts are now explicit and predictable.** The optional `@superdoc-dev/fonts` package (renamed from `@superdoc/fonts`) is now the only source for bundled font substitutes. Without it, the toolbar shows a safe baseline (Arial, Times New Roman, Courier New) and documents render with system fonts. With it configured, the full reviewed set becomes available.
- **Config-gated font availability prevents stray requests.** An unconfigured app never tries to fetch a substitute `.woff2` file it cannot serve, so there are no spurious 404s or one-time warnings. Availability is a config decision, not a runtime probe.
- **Curate bundled fonts by name with `createSuperDocFonts()`.** Use `include` to allow only specific Word families, or `exclude` to keep everything except a few. Names are validated at setup time — a typo fails fast instead of silently hiding fonts. Curation changes what the toolbar advertises and which families SuperDoc substitutes.
```js
import { createSuperDocFonts } from '@superdoc-dev/fonts';
new SuperDoc({
selector: '#editor',
document: 'contract.docx',
fonts: createSuperDocFonts({ exclude: ['Cooper Black', 'Brush Script MT'] }),
});
```
- **Document-scoped activation and curation.** Each document decides which bundled fonts it uses. A curated document never reuses a full-pack document's cached font measures, so resolution stays accurate regardless of what curation layers are in use.
### Improvements
- Updated all getting-started examples and documentation to use the new `@superdoc-dev/fonts` package and curation APIs.
- Toolbar font dropdown now correctly reflects availability based on pack configuration.
### What's New
- **Bundled fonts are now explicit and predictable.** The optional `@superdoc-dev/fonts` package (renamed from `@superdoc/fonts`) is now the only source for metric-compatible font substitutes. Without it, the toolbar shows a safe baseline (Arial, Courier New, Times New Roman) and documents render with system fonts. With it configured, the full 30-family set becomes available.
- **Config-gated font availability prevents stray requests.** An unconfigured app never tries to fetch a `.woff2` file it cannot serve — no spurious 404s, no one-time warnings. Availability is explicit, determined by your config, not discovered at runtime.
- **Curate bundled fonts by name with `createSuperDocFonts()`.** Use `include` to allow only specific Word families, or `exclude` to block a few. Names are validated at setup time — a typo fails fast with suggestions instead of silently hiding fonts. Curation changes what the toolbar advertises and which families get substituted.
```js
import { createSuperDocFonts } from '@superdoc-dev/fonts';
new SuperDoc({
selector: '#editor',
document: 'contract.docx',
fonts: createSuperDocFonts({ exclude: ['Cooper Black', 'Brush Script MT'] }),
});
```
- **Document-scoped activation and curation.** Each document independently decides which bundled fonts it uses. A curated document never reuses a full-pack document's cached font measures, so resolution stays accurate regardless of what layers are in use.
### Improvements
- Updated all getting-started examples and framework guides to use the new `@superdoc-dev/fonts` package.
- Toolbar font dropdown now correctly reflects availability based on your pack configuration.
- Font availability and curation signature are now document-scoped, eliminating cache collisions across different configurations.
### What's New
**@superdoc-dev/fonts package** — Optional npm package containing 6 MB of `.woff2` font binaries. Imports metric-compatible substitutes for proprietary Word fonts (Carlito for Calibri, Liberation Serif for Times New Roman, and others). Lets you ship the reviewed font set without a copy step or `assetBaseUrl` — bundle detects and rewrites asset URLs automatically.
**Config-gated bundled font availability** — Font availability is now explicit. Without a configured pack, SuperDoc shows a conservative baseline (Arial, Times New Roman, Courier New — one per CSS generic) and renders logical font names with system fonts. Configuring the pack via `superdocFonts`, `fonts.assetBaseUrl`/`fonts.resolveAssetUrl`, or the CDN browser build lights up the full reviewed set.
**Font curation API** — `createSuperDocFonts({ include / exclude })` narrows the pack to families you name by their Word logical names (e.g., `"Calibri"`). Validates family names at setup time, so typos fail fast. Include is an allow-list; exclude keeps everything but the named families. Does not affect custom fonts — those stay separate.
### Improvements
**Better baseline behavior** — Unconfigured SuperDoc now advertises only the safe Word baseline instead of guessing substitutes. A one-time warning surfaces if the pack fails to load instead of silently degrading.
**Document-scoped font resolution** — Font availability and curation are now per-document, so each editor's toolbar and rendering is independent when multiple documents share a page.
**CDN-ready fonts** — The `@superdoc-dev/fonts` browser build exports a global `SuperDocFonts` with the same API. Load it via `<script>` tag from jsDelivr, unpkg, or self-hosted servers — no bundler, no path config.
**Updated docs and examples** — All getting-started guides (Angular, Laravel, Next.js, Nuxt, React, Solid, Vanilla, Vue) now import and use `@superdoc-dev/fonts`.
Both doc orchestrators used a fresh per-call invoke closure as the hook scope key, so resolved track-change ids never survived between operations in a host session; a repeat trackChanges.decide on an already-resolved id then fell through to the adapter and surfaced TARGET_NOT_FOUND instead of the intended NO_OP. Key the scope by the stable opened.doc handle the session pool reuses across calls, and add an orchestrator-level regression test driving distinct per-call closures over one shared doc (existing hook tests reused a single closure and could not catch this).
…6-06-20 Merge main into stable
### Bug Fixes - linear sync ### Changes - Merge branch 'orbit-canonical-publishing' (#3699)
### What's New **Textbox object interaction** — Select, resize, and move floating DrawingML textboxes with border-click selection, corner resize handles with live feedback, and drag-to-move with margin-offset preservation. **Blocks API enhancements** — New `blocks.merge`, `blocks.split`, and `blocks.move` operations for programmatic paragraph manipulation (v2 sessions only). **Paragraph numbering control** — Surface paragraph numbering on `blocks.list` and add `format.paragraph.setNumbering` to manage numbered sequences. **Search deleted tracked changes** — Find and replace now searches within deleted tracked-change text, not just insertions. **Lists API** — New `lists.apply`, `lists.continue`, `lists.restart`, `lists.remove`, and `lists.getState` operations for list manipulation. **Mutation planning** — Add `mutations.planExecute` to plan and execute mutations in a single operation. ### Fixes **Track-change scope persistence** — Fixed resolved track-change IDs not surviving between operations in host sessions; now keys scope by stable doc handle instead of per-call closure. **Word field export** — Fixed passthrough importer attaching content to `passthroughInline` nodes, breaking MERGEFIELD and other unrecognized field export; instruction text now lives in `attrs.originalXml` only. **Footnote rendering** — Fixed footnotes silently dropped when body fills terminal page; terminal-page reserve bump now grows body on relayout when footnote demand exceeds placed reserve. **Note caret and selection** — Fixed drifting caret, selection rects, and arrow navigation in multi-paragraph note sessions by resolving geometry directly from painted pm ranges and falling back to offset bridge for unpainted positions. **Note paragraph styles** — Fixed note paragraphs losing `FootnoteText` style on Enter or paste; appended transaction now re-stamps paragraphs without styleId using nearest styled sibling's properties. **Cross-paragraph deletion in suggesting mode** — Fixed deletion spanning two paragraphs splitting instead of re-joining; `replaceStep.js` now compiles slices without inline content as plain tracked deletions and emits explicit caret hint. **IME composition** — Deferred layout rerender and track-changes rewriting during IME composition to prevent editing breaks. **Tracked-change review navigation** — Fixed review navigation getting stuck and unable to return to previous position. **First-line list indentation** — Fixed justified-text width for numbered lists with first-line indent by computing marker-suffix tab width from actual tab stops instead of stale textStartX targets. **Orphan calls** — Removed orphan superdoc-dev environment calls. ### Improvements **Footnote keystroke performance** — Warm-start reserve convergence from previous fixed point, reducing footnote pipeline cost from 75ms to 12ms per keystroke on 25-footnote document. **Numbering recompute** — Skip numbering plugin's full-document diff on `BLOCK_NODE_METADATA_UPDATE_META` transactions; saves ~16ms per keystroke on 776-paragraph documents. **Toolbar refresh coalescing** — Coalesce headless toolbar refresh per microtask when `transaction` and `selectionUpdate` fire synchronously; eliminates redundant snapshot rebuilds. **Layout engine** — Fold footnote warm-start seed into initial pagination for single-pagination steady state; page-token relayout preserves seeded options. **V2 architecture** — New v2 package with unified editor runtime, review state management, drawing taxonomy for shape/textbox support, and v1 compatibility wiring. **Test coverage** — 70+ new comprehensive tests covering v2 wiring, custom UI parity, mutations, and block API operations.
### What's New **Document API — Image commands** — Crop, rotate, scale, flip, and replace images programmatically. Set alt text, captions, z-order, anchor options, and wrapping behavior. (#2290, #2295) **Document API — Hyperlink commands** — Insert, get, list, patch, and remove hyperlinks. Wrap text in links. Full control over DOCX link elements. (#2294) **Pasted hyperlinks** — Converting pasted text into real docx link elements instead of plain text. (#2270) **Document API — Lists commands** — Apply list templates, set level-specific formatting (alignment, bullets, numbering, indentation, marker fonts, trailing characters). Improved sequence continuity when changing list types. (#2288, #2304) **Clear content command** — Remove document content programmatically. (#2300) **Table insertion** — Insert table with extra separator row to match MS Word behavior. (#2301) **HTML extraction** — New `getHtml` operation to read document content as HTML. (#2264) **TIFF image support** — Render TIFF images in DOCX documents alongside PNG, JPG, and GIF. (#2284) **Markdown image import** — Automatically import images when converting markdown to documents. (#2303) **Partial tracked change resolution** — Resolve individual tracked changes without resolving all. (#2252) **LLM tools** — Alpha release of llm tools integration. (#2292) **Web view layout engine** — New rendering engine for improved document layout and performance. (#2100) ### Improvements **Document API — Styles** — Registry-driven `styles.apply` with schema validation for type safety. (#2267) **SDK type definitions** — Added TypeScript types for `PresentationEditor`. (#2271) **HTML operations** — Fixed HTML insert and improved SDK tool selection. (#2264) **SDK API** — Made `expectedRevision` parameter optional. (#2265) **Python SDK documentation** — Operations now render as snake_case in generated docs. (#2266) ### Fixes **Header/footer editing** — Prevent focus loss when typing in header/footer editors. (#2238) **Image resize handles** — Align handles with actual image position. (#2293) **Virtualization scroll** — Compute scroll position relative to scroll container, not viewport. (#2263) **Format persistence** — Route `format.caps` through text transform so `w:caps` persists on export. (#2297) **List export** — Sync document XML before numbering pruning to preserve list definitions. (#36058c364) **Link popover rendering** — Mount external popovers outside overflow:hidden containers. (#2308) **Media handling** — Handle Uint8Array media values from persistence layers. (#2298) **Scroll feedback loop** — Prevent scroll acceleration feedback loop in painter DOM. (#2291) **Collaboration sessions** — Keep sessions alive in non-collaborative mode; checkpoint sessions even when not dirty. (#2289) **CLI collaboration** — Prevent collab reopen from overwriting existing document with blank data. (#2296) **Markdown conversion** — Harden markdown image conversion error handling. (#2303) **Portrait orientation** — Fix document API handling of portrait orientation. (#dafab76af) **Development experience** — Log warning when local dev server is unreachable. (#2309) **Test stability** — Stabilize flaky `cleanUpParagraphWithAnnotations` tests. (#2262)
### What's New **Footnote and endnote editing** — Double-click body markers to open notes, two-press Backspace to delete, clearing note content removes the footnote on both sides. **Document API — Image commands** — Crop, rotate, scale, flip, and replace images programmatically; set alt text, captions, z-order, and wrapping. **Document API — Hyperlink commands** — Insert, get, list, patch, and remove hyperlinks; wrap text in links with full DOCX control. **Pasted hyperlinks** — Automatically converts pasted URLs into real docx link elements instead of plain text. **Document API — Lists commands** — Apply list templates, set level-specific formatting (alignment, bullets, numbering, indentation, marker fonts). **Document API — Table insertion** — Insert tables with extra separator row to match MS Word behavior. **Textbox object interaction** — Select, resize, and move DrawingML textboxes with border-click selection, corner handles, and drag-to-move feedback. **Blocks API enhancements** — New merge, split, and move operations for programmatic paragraph manipulation (v2 sessions). **Paragraph numbering control** — Surface paragraph numbering on blocks.list; add format.paragraph.setNumbering for managing numbered sequences. **Search deleted tracked changes** — Find and replace now searches within deleted tracked-change text, not just insertions. **Lists API** — New lists.apply, lists.continue, lists.restart, lists.remove, and lists.getState operations. **Mutation planning** — Plan and execute mutations in a single operation with mutations.planExecute. **Clear content command** — Remove document content programmatically. **HTML extraction** — New getHtml operation to read document content as HTML. **TIFF image support** — Render TIFF images alongside PNG, JPG, and GIF. **Markdown image import** — Automatically import images when converting markdown to documents. **Partial tracked change resolution** — Resolve individual tracked changes without resolving all. **LLM tools** — Alpha release of LLM tools integration. **Web view layout engine** — New rendering engine for improved layout and performance. ### Improvements **Document API styles** — Registry-driven styles.apply with schema validation for type safety. **PresentationEditor types** — Added TypeScript types for PresentationEditor. **SDK API** — Made expectedRevision parameter optional. **Footnote keystroke performance** — Warm-start reserve convergence reduces keystroke cost on 25-footnote documents from 75ms to 12ms. **Numbering recompute** — Skip full-document diff on block-node metadata transactions; saves ~16ms per keystroke on 776-paragraph documents. **Toolbar refresh coalescing** — Coalesce headless toolbar refresh per microtask to eliminate redundant snapshot rebuilds. **Layout engine** — Fold footnote warm-start seed into initial pagination for single-pagination steady state. **V2 architecture** — New v2 package with unified editor runtime, review state management, drawing taxonomy, and v1 compatibility wiring. **Test coverage** — 70+ new tests covering v2 wiring, custom UI parity, mutations, and block API operations. ### Fixes **Track-change scope persistence** — Fixed resolved track-change IDs not surviving between operations in host sessions. **Word field export** — Fixed passthrough importer breaking MERGEFIELD export; instruction text now lives in attrs.originalXml only. **Footnote rendering** — Fixed footnotes silently dropped when body fills terminal page. **Note caret and selection** — Fixed drifting caret, selection rects, and arrow navigation in multi-paragraph notes. **Note paragraph styles** — Fixed note paragraphs losing FootnoteText style on Enter or paste. **Cross-paragraph deletion** — Fixed deletion spanning two paragraphs splitting instead of re-joining in suggesting mode. **IME composition** — Deferred layout rerender and track-changes rewriting during IME composition. **Tracked-change review navigation** — Fixed review navigation getting stuck. **First-line list indentation** — Fixed justified-text width for numbered lists with first-line indent. **Header/footer editing** — Prevent focus loss when typing in header/footer editors. **Image resize handles** — Align handles with actual image position. **Virtualization scroll** — Compute scroll position relative to scroll container, not viewport. **Format persistence** — Route format.caps through text transform so w:caps persists on export. **List export** — Sync document XML before numbering pruning to preserve list definitions. **Link popover rendering** — Mount external popovers outside overflow:hidden containers. **Media handling** — Handle Uint8Array media values from persistence layers. **Scroll feedback loop** — Prevent scroll acceleration feedback loop in painter DOM. **Collaboration sessions** — Keep sessions alive in non-collaborative mode; checkpoint when not dirty. **CLI collaboration** — Prevent collab reopen from overwriting documents with blank data. **Markdown conversion** — Harden markdown image conversion error handling. **Portrait orientation** — Fix document API handling of portrait orientation. **Development experience** — Log warning when local dev server is unreachable.
### Fixes - **First-line list indentation** — Fixed incorrect text start position for numbered lists with first-line indents. The layout engine now computes marker widths from actual rendered tab stops instead of stale measurements, ensuring correct justified text width calculations. - **Fonts configuration robustness** — Malformed `fonts.bundled` configuration no longer crashes the editor. Hand-written config with invalid shapes (e.g., bare strings instead of arrays) now defaults to the full bundled pack and logs a single warning instead of throwing.
### What's New **Footnotes and endnotes — full editor integration** — Double-click a reference marker to navigate to the note; delete from either side removes both marker and note; staged Backspace selects then removes; insert via `editor.commands.insertFootnote()`; caret and arrow navigation now track correctly in multi-paragraph notes; Font sizing respects document defaults. **Textbox selection, resize, and move** — Click within 6px of a textbox border to select it (ProseMirror NodeSelection); resize via corner handles with live feedback; drag to move with margin-offset preservation; works in body, headers, and footers. **Document API — image manipulation** — `images.crop`, `images.rotate`, `images.scale`, `images.flip`, `images.replace-source`; full control over alt text, captions, z-order, wrapping, and anchor; TIFF support added. **Document API — hyperlinks** — `hyperlinks.insert`, `hyperlinks.wrap`, `hyperlinks.list`, `hyperlinks.patch`, `hyperlinks.remove`; pasted URLs automatically convert to real DOCX link elements. **Document API — list operations** — `lists.apply`, `lists.continue`, `lists.restart`, `lists.remove`, `lists.getState`; level-specific formatting; control bullets, numbering, alignment, marker fonts, and indentation. **Document API — block operations (v2 sessions)** — `blocks.merge` preserves first paragraph properties; `blocks.split`; `blocks.move`; returns affected ranges and transaction IDs. **Document API — paragraph numbering** — `format.paragraph.setNumbering` attaches numbering to paragraphs; `blocks.list` surfaces list state; `format.paragraph.setMarkRunProps` controls marker appearance. **Search in tracked deletions** — Find & Replace now searches text within deleted tracked changes, not just insertions. **Cross-reference navigation** — Double-click a REF or NOTEREF field pointing at a footnote/endnote to navigate to that note. **Mutations planning** — `mutations.planExecute` plans and executes mutations in a single operation with per-entry transactions and failure semantics. **HTML extraction** — New `getHtml` operation to read document content as HTML. **V2 package and runtime** — Unified v2 editor runtime with improved performance; v1 compatibility wiring for backward compatibility. ### Improvements **List rendering fidelity** — First-line indent lists now compute marker suffix tab width from actual rendered tab stops instead of stale targets; justified text width is now correct. **Footnote performance** — Warm-start reserve convergence reduces keystroke cost on 25-footnote documents from 75ms to 12ms; ONE pagination per keystroke instead of nine. **Editor performance** — Block-node metadata transactions no longer trigger full-document numbering diffs; saves ~16ms per keystroke on 776-paragraph documents. **Toolbar refresh** — Coalesce headless toolbar snapshots per microtask; eliminates redundant rebuilds on transaction + selectionUpdate bursts. **IME composition** — Defer layout rerender and track-changes rewriting during input method editing to prevent conflicts. **Font configuration robustness** — Malformed `fonts.bundled` configuration no longer crashes; defaults to full bundled pack with warning. **Track changes — deletion handling** — Cross-paragraph deletes no longer split paragraphs in suggesting mode; position mapping no longer crashes; accept/reject now reports which decision was taken. **URL paste intent detection** — Auto-linking now requires explicit URL intent (`www.`, `http(s)://`, `mailto:`, `tel:`, `sms:`) to prevent plain text or relative paths from being mistakenly linked. **Passthrough nodes** — Inline passthrough nodes no longer attach content; instruction text lives in attrs.originalXml to fix MERGEFIELD export. ### Fixes **Footnotes rendering** — Terminal-page reserve bump now ensures footnotes render when body fills last page (was silently dropping 0 of 6). **Note caret and selection** — Multi-paragraph notes now track caret and selection correctly; arrow navigation no longer skips lines; goal-column preserved across presses; resolves against stale painted ranges via block identity. **Note paragraph styles** — FootnoteText style now preserved on Enter, paste, and every paragraph-creation path; appendTransaction guard stamps missing styles after async mutations. **Header/footer activation** — Double-click resolves note references only in body fragments; header/footer with behindDoc textboxes no longer break. **Tracked-change review navigation** — Navigation no longer jumps and leaves the UI in inconsistent states. **Comment behavior regressions** — Repaired regression in comment behavior after recent refactors. **Format persistence** — `w:caps` now persists on export via text transform. **List export** — Sync document XML before numbering pruning to preserve list definitions on export. **Image resize handles** — Alignment with actual image position corrected. **Link popover rendering** — Mount external popovers outside overflow:hidden containers to prevent clipping. **Orphan references** — Removed orphan function calls that left the codebase in an inconsistent state. **Security findings** — Remediated critical and high penetration test findings.
### What's New **Footnotes and endnotes — full editor integration** — Double-click a reference marker to navigate to the note; delete from either side removes both marker and note; staged Backspace selects then removes; insert via `editor.commands.insertFootnote()`; caret and arrow navigation track correctly in multi-paragraph notes; font sizing respects document defaults. **Textbox selection, resize, and move** — Click within 6px of a textbox border to select it (ProseMirror NodeSelection); resize via corner handles with live feedback; drag to move with margin-offset preservation; works in body, headers, and footers. **Document API — image manipulation** — `images.crop`, `images.rotate`, `images.scale`, `images.flip`, `images.replace-source` for full control over alt text, captions, z-order, wrapping, and anchor; TIFF support added. **Document API — hyperlinks** — `hyperlinks.insert`, `hyperlinks.wrap`, `hyperlinks.list`, `hyperlinks.patch`, `hyperlinks.remove`; pasted URLs automatically convert to real DOCX link elements. **Document API — list operations** — `lists.apply`, `lists.continue`, `lists.restart`, `lists.remove`, `lists.getState` with level-specific formatting; control bullets, numbering, alignment, marker fonts, and indentation. **Document API — block operations (v2 sessions)** — `blocks.merge` preserves first paragraph properties; `blocks.split`; `blocks.move`; returns affected ranges and transaction IDs. **Document API — paragraph numbering** — `format.paragraph.setNumbering` attaches numbering to paragraphs; `blocks.list` surfaces list state; `format.paragraph.setMarkRunProps` controls marker appearance. **Search in tracked deletions** — Find & Replace now searches text within deleted tracked changes, not just insertions. **Cross-reference navigation** — Double-click a REF or NOTEREF field pointing at a footnote or endnote to navigate to that note. **Mutations planning** — `mutations.planExecute` plans and executes mutations in a single operation with per-entry transactions and failure semantics. **HTML extraction** — New `getHtml` operation to read document content as HTML. **V2 package and runtime** — Unified v2 editor runtime with improved performance; v1 compatibility wiring for backward compatibility. ### Improvements **List rendering fidelity** — First-line indent lists now compute marker suffix tab width from actual rendered tab stops instead of stale targets; justified text width is now correct. **Footnote performance** — Warm-start reserve convergence reduces keystroke cost on 25-footnote documents from 75ms to 12ms; one pagination per keystroke instead of nine. **Editor performance** — Block-node metadata transactions no longer trigger full-document numbering diffs; saves ~16ms per keystroke on 776-paragraph documents. **Toolbar refresh** — Coalesce headless toolbar snapshots per microtask; eliminates redundant rebuilds on transaction + selectionUpdate bursts. **IME composition** — Defer layout rerender and track-changes rewriting during input method editing to prevent conflicts. **Font configuration robustness** — Malformed `fonts.bundled` configuration no longer crashes; defaults to full bundled pack with warning. **Track changes — deletion handling** — Cross-paragraph deletes no longer split paragraphs in suggesting mode; position mapping no longer crashes; accept/reject now reports which decision was taken. **URL paste intent detection** — Auto-linking now requires explicit URL intent (`www.`, `http(s)://`, `mailto:`, `tel:`, `sms:`) to prevent plain text or relative paths from being mistakenly linked. **Passthrough nodes** — Inline passthrough nodes no longer attach content; instruction text lives in `attrs.originalXml` to fix MERGEFIELD export. ### Fixes **Footnotes rendering** — Terminal-page reserve bump ensures footnotes render when body fills last page. **Note caret and selection** — Multi-paragraph notes now track caret and selection correctly; arrow navigation no longer skips lines; goal-column preserved across presses. **Note paragraph styles** — FootnoteText style now preserved on Enter, paste, and every paragraph-creation path. **Header/footer activation** — Double-click resolves note references only in body fragments; behindDoc textboxes no longer break activation. **Tracked-change review navigation** — Navigation no longer jumps and leaves the UI in inconsistent states. **Comment behavior regressions** — Repaired regression in comment behavior after recent refactors. **Format persistence** — `w:caps` now persists on export via text transform. **List export** — Sync document XML before numbering pruning to preserve list definitions on export. **Image resize handles** — Alignment corrected to match actual image position. **Link popover rendering** — Mount external popovers outside `overflow:hidden` containers to prevent clipping. **Orphan references** — Removed orphan function calls that left the codebase in an inconsistent state. **Security** — Remediated critical and high penetration test findings.
### What's New **Footnotes and endnotes — full editor integration** — Double-click a reference marker to navigate to the note. Staged Backspace selects the marker, second press removes it (and the note). Delete from the note area removes both marker and note. Caret and arrow navigation now track correctly in multi-paragraph notes. Insert notes via `editor.commands.insertFootnote()`. Font sizing respects document defaults. **Textbox selection, resize, and move** — Click within 6px of a textbox border to select it as a ProseMirror NodeSelection instead of placing a caret. Drag corner handles to resize with live feedback. Drag the textbox to move; margins update to keep the opposite corner fixed. Works in body, headers, and footers. **Document API — image manipulation** — `images.crop`, `images.rotate`, `images.scale`, `images.flip`, `images.replace-source`. Full control over alt text, captions, z-order, wrapping, and anchor. TIFF support added. **Document API — hyperlinks** — `hyperlinks.insert`, `hyperlinks.wrap`, `hyperlinks.list`, `hyperlinks.patch`, `hyperlinks.remove`. Pasted URLs automatically convert to real DOCX link elements. **Document API — list operations** — `lists.apply`, `lists.continue`, `lists.restart`, `lists.remove`, `lists.getState`. Level-specific formatting. Control bullets, numbering, alignment, marker fonts, and indentation. **Document API — block operations (v2 sessions)** — `blocks.merge` preserves first paragraph properties; `blocks.split`, `blocks.move`. Returns affected ranges and transaction IDs. **Document API — paragraph numbering** — `format.paragraph.setNumbering` attaches numbering to paragraphs. `format.paragraph.setMarkRunProps` controls marker appearance. **Search in tracked deletions** — Find & Replace now searches text within deleted tracked changes, not just insertions. **Cross-reference navigation** — Double-click a REF or NOTEREF field pointing at a footnote or endnote to navigate to that note. **Mutations planning** — `mutations.planExecute` plans and executes mutations in a single operation with per-entry transactions and failure semantics. **HTML extraction** — New `getHtml` operation to read document content as HTML. **V2 package and runtime** — Unified v2 editor runtime with improved performance and v1 compatibility wiring for backward compatibility. ### Improvements **Footnote performance** — Warm-start reserve convergence reduces keystroke cost on 25-footnote documents from 75ms to 12ms. One pagination per keystroke instead of nine. **Editor performance** — Block-node metadata transactions no longer trigger full-document numbering diffs; saves ~16ms per keystroke on 776-paragraph documents. Toolbar snapshots now coalesce per microtask, eliminating redundant rebuilds. **List rendering** — First-line indent lists now compute marker suffix tab width from rendered tab stops instead of stale targets. Justified text width is now correct. **IME composition** — Layout rerender and track-changes rewriting now defer during input method editing to prevent conflicts. **Font configuration robustness** — Malformed `fonts.bundled` configuration no longer crashes; defaults to full bundled pack with warning. **Track changes — deletion handling** — Cross-paragraph deletes no longer split paragraphs in suggesting mode. Position mapping no longer crashes. Accept/reject now reports which decision was taken. **URL paste intent detection** — Auto-linking now requires explicit URL intent (`www.`, `http(s)://`, `mailto:`, `tel:`, `sms:`) to prevent plain text or relative paths from being mistakenly linked. **Passthrough nodes** — Inline passthrough nodes no longer attach content; instruction text lives in attrs.originalXml to fix MERGEFIELD export. ### Fixes **Footnotes rendering** — Terminal-page reserve bump now ensures footnotes render when body fills last page. **Note caret and selection** — Multi-paragraph notes now track caret and selection correctly. Arrow navigation no longer skips lines. Goal-column preserved across presses. **Note paragraph styles** — FootnoteText style now preserved on Enter, paste, and all paragraph-creation paths. **Header/footer activation** — Double-click resolves note references only in body fragments. Headers/footers with behindDoc textboxes no longer break. **Tracked-change review navigation** — Navigation no longer jumps and leaves the UI in inconsistent states. **Comment behavior** — Repaired regressions in comment behavior. **Format persistence** — `w:caps` now persists on export via text transform. **List export** — Sync document XML before numbering pruning to preserve list definitions on export. **Image resize handles** — Alignment with actual image position corrected. **Link popover rendering** — Mount external popovers outside overflow:hidden containers to prevent clipping. **Orphan references** — Removed orphan function calls that left the codebase in inconsistent state. **Security** — Remediated critical and high penetration test findings.
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
Contributor
Author
|
This pull request landed on |
Contributor
Author
|
🎉 This PR is included in superdoc-cli v0.20.2 The release is available on GitHub release |
Contributor
Author
|
🎉 This PR is included in superdoc-sdk v1.19.2 |
Contributor
Author
|
🎉 This PR is included in @superdoc-dev/mcp v0.15.2 The release is available on GitHub release |
Contributor
Author
|
🎉 This PR is included in @superdoc-dev/fonts v0.1.3 The release is available on GitHub release |
Contributor
Author
|
🎉 This PR is included in superdoc v1.43.2 The release is available on GitHub release |
Contributor
Author
|
🎉 This PR is included in @superdoc-dev/react v1.14.2 The release is available on GitHub release |
Contributor
Author
|
🎉 This PR is included in vscode-ext v2.15.2 |
Contributor
Author
|
🎉 This PR is included in template-builder v1.12.2 The release is available on GitHub release |
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
3 participants
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.
Summary
Merges latest stable patches into main with a real merge commit so stable release tags remain reachable from main.
This keeps
@nextprerelease version calculation ahead of the latest published stable release.Merge requirement
This PR must be merged with GitHub's merge-commit option. Squash or rebase merging will discard stable ancestry and break
@nextversion calculation again.Conflict handling
Merge status:
clean.Version-only release artifact conflicts are auto-resolved to keep stable's already-published versions. Non-version conflicts fail this workflow instead of committing conflict markers.
Auto-created by sync-patches workflow.