* fix: Allow PDF embed width and height to change independently
Adds an aspect ratio lock toggle to the media dimension toolbar for PDF
embeds, renders PDFs at their stored aspect ratio, and keeps that ratio
when drag resizing.
* feat: Add corner resize handles to PDF embeds and persist aspect ratio lock
Stores the lock as an optional attachment attribute, where unset means
locked, so side handles change only the width of unlocked PDFs.
* feat: Consistent resize handles for images, videos, PDFs and embeds
All media get side, bottom and corner handles driven by one lock rule.
Images and videos stay locked. PDFs and embeds can be unlocked to resize
each axis independently.
* feat: Show width, height and lock in the embed toolbar
* feat: Start embeds unlocked and step media dimensions with arrow keys
Embeds start with an unlocked aspect ratio so full-width embeds can still
be made taller, while PDFs start locked. Up and down arrows step the
dimension inputs by 1, or 10 with shift.
* fix: Align the aspect ratio padlock with the dimension digits
* fix: Move the aspect ratio lock closer to the dimension inputs
* fix: Show the aspect ratio lock state in its tooltip
* feat: Show a display menu on hover for mentions that can be cards
Mentions that can display as a card show an overflow button on hover,
inside the end of the pill or in the top corner of the card. The button
opens a menu to switch between the mention and card display, which
replaces the selection toolbar for these mentions.
* fix: Resolve the mention position on click and hide the button on scroll
The menu looks up the mention position when an item is chosen, as edits
by collaborators can move it while the menu is open. The button follows
the mention when content above it changes and hides when a table is
scrolled.
* feat: Show the mention display button for a selected mention
The button shows for the selected mention as well as the hovered one, so
keyboard users can reach it. Touch devices show it for the selected mention
only. Only the button takes the pointer, so the fade does not block clicks
on short mentions.
* feat: Add filtering to tables in the editor
* Show the column filter button on header hover in edit mode
* Keep the filter button shown while its menu is open
* Move focusEditor to its own module
* Anchor the filter menu to the filter button
* Address review feedback on table filtering
* Show the filter button background while its menu is open
* Always show the filter button background with its icon
* Remove value counts and hide Clear when there is no filter
* Translations
* placeholder
* fix: Keep notices and rules nested in lists and quotes when serialized to Markdown
* fix: Keep the blank line above notices and rules, written per line
* feat: Display links as preview cards
Adds a display attribute to mentions so a link can render either inline
or as a card with image, title and description from its unfurl. Pasting
a URL offers a "Card" option, and selecting a link mention shows a
toolbar to switch between the two displays.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016MJXFgeTUqKhSTriUHfG3z
* feat: Arrow key selection, full width and Return for link cards
Cards fill the document width, hide the blank line below them, are selected
by the up and down arrow keys like images, and Return on a selected card
adds a paragraph below it.
* feat: Display document and collection mentions as cards
Document and collection mentions can be switched to a card from the
selection toolbar. Document cards show the summary, collection and the
first image larger than 100x100. Collection cards show the first line of
the description. On public shares the preview image is signed, as the
share page already signs the attachments of that document. Card images
are hidden until they load and removed if they fail.
* feat: Keep mention cards through Markdown
The card display is written as the link title, so URLs are not changed.
Document and collection cards are written as @ links to their id and
parsed back into mentions.
* refactor: Move mention cards to their own file
Document cards show the collection after the title instead of below it.
* fix: Address review feedback on mention cards
- Include the share id in the document card unfurl URL for root shares.
- Return on a card in a heading adds a paragraph.
- URL cards keep their URL in Markdown, and the server does not narrow
their type.
- Unfurl results apply to the current node, not the node at first render.
- Collection card descriptions stop at the first line break.
* refactor: Reuse existing helpers for mention cards
- Sign the preview image with TextHelper.attachmentsToSignedUrls.
- Check document and collection ids with isUUID.
- Return lines from getFirstText without changing an input array.
* fix: Preserve JSON output for inline mentions
* refactor: Centralize mention selection classes
---------
Co-authored-by: Claude <noreply@anthropic.com>
* fix: Viewers attributed as editors when their editor repairs remote changes
* fix: Rescan after remote changes and assign block ids when parsing markdown
* chore: Import uuid as generateUuid in ToggleBlock
* refactor: Add RepairPlugin to repair only on local changes, checking remote changes for pending repairs
* fix: Assign block ids on the server so patches keep existing ids, keep unchanged mention ids
* fix: Store API edits in the editor's trailing node form
Move the header row with a CSS scroll-driven animation so the browser updates it in the same frame as the scroll. Browsers without support keep the scroll listener.
* feat: Allow tables inside notices
Blend table, rule and code colors onto the notice background, keep table
scroll shadows inside the notice, hide full width for tables in notices,
and fit new table columns to the available width.
* fix: Leave room for table row controls in notices
* fix: Blend table grips onto the notice background
* fix: Derive notice content colors from the softer notice styles
* feat: Show code block line numbers alongside line wrapping
Render line numbers as a widget at the start of each line so they align
with wrapped lines and stay fixed during horizontal scroll.
* fix: Keep line number gutter size inside table cells
* feat: Add selection toolbar for video nodes
* fix: Keep video caption on replace, download video as a file
* fix: Drop removed upload progress prop from video replace
* feat: Render uploading images and videos with their node component
* fix: Insert uploaded block nodes next to the paragraph instead of inside it
* fix: Insert dropped block nodes on the nearest side of the paragraph
* feat: Fade in uploaded images and videos from their placeholder
* feat: Preview the new image while it replaces an existing one
* fix: Keep the placeholder size and preload pasted images after upload
* fix: Move the selection off an image while an upload replaces it
* feat: Play uploaded videos from the local file in the uploading editor
* feat: Display uploaded images from the local file in the uploading editor
* feat: Soften image and video corners, round them fully when selected
* feat: Render uploading attachments with the attachment component
* feat: Show the file size of an attachment while it uploads
* feat: Show upload progress on the placeholder instead of a toast
* fix: Fade the content of an uploading file but not its progress bar
* fix: Keep the local file of an upload when its placeholder is mapped away
* chore: Simplify upload placeholder state and remove unused progress callback
* Remove test
* fix: Address review feedback on upload placeholders
Expose upload progress to assistive technology outside the inert placeholder, free local files when the editor state is replaced, reuse the fadeIn animation and move the video wrapper class to EditorStyleHelper.
* chore: Move image and PDF wrapper class names to EditorStyleHelper
* feat: Scale in an upload placeholder when it appears
* chore: Make the upload placeholder scale-in more subtle
Table grip and insert widgets at the start of a cell made ProseMirror treat the
grip as the first block of the cell, so RTL deletion was always blocked. The
add row and column controls now also show above the grips while hovered.
* Expanding drag handle to all root level block nodes
* wip
* looking good
* wip
* fix, drag video nodes
* fix mermaid
* Hide drag handle when printing, adjust heading actions for handle gutter
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
* rtl
* Passive scroll listener, avoid dispatch on teardown
* Guard drag handle from re-showing mid-drag, use semantic button
* Align drag handle to first line, hide on layout images, tidy heading controls
* Fix stale drag handle target and drag data, rebuild Mermaid in moved containers, remove unused styles
* Extract drag handle target resolution into DragTarget class
* Move drag handle styles from inline to global CSS
* Use EditorStyleHelper class names and named constants in drag handle, translate its label
* Hide drag handle on a table that holds the selection
* Remove opacity transition from drag handle
* Move heading anchor into drag handle slot when read-only
* Move drop cursor class name to EditorStyleHelper
* Add empty line above comments, document the rule in AGENTS.md
* drag handle
---------
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
* fix: Guard node view positions after the view is destroyed
ProseMirror returns undefined from getPos once a node view is destroyed,
but ComponentProps typed it as always returning a number. Async handlers,
such as the mention unfurl, could then call setNodeMarkup with an undefined
position and throw a RangeError.
Fixes OUTLINE-CLOUD-D9N
* Remove excessive test
* wip
* fix: Position grips in merged cells from the rendered layout
* fix: Only merge row and column selections that cover whole rows or columns
* perf: Find merged cell spans without scanning the table map
* refactor: Extract helpers for cells starting in a row or column
Treat checkbox list attribute changes as structural for id repair, keep
remote transactions on the rebuild path for table decorations, and map
column grip decorations through local inline edits.
* perf: Map editor decorations through inline edits instead of rebuilding
* fix: Repair missing block ids on first edit and keep remote edits on the rebuild path
* test: Add isInlineTransaction query tests
* fix: Crash when image caption blurs during node view teardown
The caption blur handler ran setNodeMarkup using a position from a node
view that had already been destroyed, so the position was undefined and
ProseMirror threw a RangeError walking the document. Guard that the
position still resolves to the same node type before dispatching, for
both image and video captions.
Fixes OUTLINE-CLOUD-D6D
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Hggmor4gWv2Ei4pMNeeMh4
* chore: Remove caption blur tests
Native drags (ProseMirror nodes leaving the editor, text, files) are
tracked by react-dnd as native item types. The sidebar drag placeholder
rendered a document row for any active drag, so dragging an editor node
past the editor edge showed an "Untitled" document ghost.
Also makes notice blocks non-draggable.
* feat: Alt-click toggle disclosure folds or unfolds all toggle blocks
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
* Alt toggles nested blocks, Mod toggles all blocks
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
---------
Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
* fix(editor): preserve toggle fold state across remote and local document edits
Fold state was re-derived from localStorage on every remote collaborative
transaction (and partially on local doc-changing ones), so a silently
failed Storage.set (quota exceeded, blocked storage) left a stale
{fold:true} and the next edit re-folded blocks the user had expanded —
the plugin seed from previous state was ineffective because
toggleFoldPluginKey.getState(newState) is always undefined during the
plugin's own apply.
Track a knownIds set alongside foldedIds and reconcile from the previous
plugin state (the second apply argument, which is reliable): existing
fold decisions are preserved verbatim and storage is only consulted for
toggle blocks seen for the first time.
Fixes#13424
* fix(editor): bound and harden toggle fold state persistence
Fold state was stored under a localStorage key per toggle block id with
no bound on how many keys accumulate, and a write that failed silently
(quota exceeded, storage unavailable) left a stale value that the next
edit would re-fold from. Two complementary changes:
- Storage falls back to session storage when a write to the primary
interface fails at runtime, so values at least survive the browsing
session; reads prefer the fallback copy while it is the most recent
successful write, and successful writes drop it again.
- Toggle fold state now lives in an LRUCache mirrored to local storage,
capping the number of stored keys and evicting the least recently used
fold states first. The persisted key format is unchanged so fold state
continues to sync across tabs via storage events.
Follow-up to #13425, addressing the underlying feedback in #13424.
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: add development workflow best practices to CLAUDE.md
Co-Authored-By: Claude <noreply@anthropic.com>
* fix(editor): rename persistTo option to storage in LRUCache
Rename the `persistTo` cache option to `storage` with a union type of
`"memory" | "localStorage" | "sessionStorage"` per review feedback.
The option is now required instead of optional; callers that only need
an in-memory cache pass `storage: "memory"`.
The private Storage instance field is renamed from `storage` to `store`
to avoid colliding with the new option name, and the mapping from
user-facing values to Storage constructor arguments is handled in
`hydrate()`.
Co-Authored-By: Claude <noreply@anthropic.com>
* fix(editor): eliminate redundant findBlockNodes scan in reconcileFoldState
The hot path for every local document change previously called
findBlockNodes twice on the same document — once in reconcileFoldState
and again in createDecorations. Now reconcileFoldState collects the
blocks once and passes them directly to the decoration builder.
Co-Authored-By: Claude <noreply@anthropic.com>
* fix(editor): fix createDecorations signature to accept optional blocks parameter
The init and ACTION branches pass a NodeWithPos[] as the second argument,
which previously landed in the foldedIds parameter — a type error missed
due to missing tsc validation.
Co-Authored-By: Claude <noreply@anthropic.com>
* fix(editor): correct createDecorations argument order and NodeWithPos import
The createDecorations signature is (doc, foldedIds, blocks?) but both the
init and ACTION branches passed arguments in the old order (doc, blocks,
foldedIds). Because the Set is always truthy, the ?? fallback never fired
and buildDecorationsFromBlocks iterated over strings, crashing on
block.node.attrs. NodeWithPos is also not exported from findChildren.
Co-Authored-By: Claude <noreply@anthropic.com>
* fix(editor): address review feedback and fix CI
- Document the default-folded fallback for evicted blocks in the
fold-state cache comment.
- Cast the Storage test mock through unknown so the type check passes.
- Provide in-memory web storage for the shared jsdom test project so the
persistence tests run instead of crashing on a missing implementation.
Co-Authored-By: Claude <noreply@anthropic.com>
* fix(editor): scope storage fallback writes and drop unrelated changes
- Track keys mirrored to the storage fallback and clear only those,
rather than clearing all of session storage
- Restore CLAUDE.md as a symlink to AGENTS.md
- Remove the unrelated scrollToNonce changes
- Make the fallback interface private and probe with a namespaced key
Co-Authored-By: Claude <noreply@anthropic.com>
---------
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Tom Moor <tom@getoutline.com>
* checkpoint
* feat: Convert @ prefixed links to mentions on server Markdown writes
A Markdown link preceded by "@" now becomes a mention when brought in
through the documents API, MCP, or an import, so an exported mention
survives a round trip instead of degrading to a plain link.
The editor rule creates a generic mention carrying the href, and the
type of resource it points at is resolved by the plugin that recognizes
the URL through a new MentionProvider hook. Mentions of external
resources also serialize to their real URL rather than a mention:// URI,
so the reference resolves outside of Outline.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* fix: Escape values interpolated into rendered mention HTML
markdown-it leaves markup in a link label intact when html is disabled,
so the label and attributes are escaped before being written into the
tag.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Add heading numbering display preference for documents
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* Fix isRemoteTransaction call for new signature on main
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* Fix inTable detection for headings after a nested table
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* Move from deco to pseudoclass
---------
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
The heading node bound its caret-sync handler to Mod-ArrowLeft, which
Prosemirror maps to Ctrl on Linux and Windows. The handler moved the
selection to the start of the heading, replacing the word-left movement
that Ctrl+Left performs everywhere else.
Bind Cmd rather than Mod, so the handler only runs for the shortcut it
was written for.
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* fix: Sanitize the embed toolbar link and anchor embed url matchers
The "Open" link in an embed's bottom bar wrote the node's href attribute
into the DOM without passing it through sanitizeUrl, so a javascript: url
in that attribute ran on click.
Two embed matchers, and the regex built from a team's embed integration
settings, were not anchored, so a javascript: url that contained a
supported url further along still matched an embed and reached that link.
* fix: Only emit a list style the editor renders
The listStyle attribute is written into a list-style-type declaration.
Its validator returned a boolean rather than throwing, which Prosemirror
ignores, so any string reached the style attribute and a crafted value
appended further CSS declarations to the element.
* fix: Sanitize the image urls carried in a mention's unfurl attribute
The unfurl attribute holds a cached copy of the unfurl response on the
node, and is used whenever the store has no live entry for the url. Its
favicon and avatar urls were written to an img src unchanged, so a
crafted mention made every reader's browser request a chosen host.
* fix: Render a heading level and highlight color that cannot be used
Both attributes are used unchecked when the node is rendered. rgba()
throws for a color it cannot parse, and a level outside of 1-6 produces
an invalid tag name, so either one stopped the whole document rendering
in the browser and on the server. The heading level also reached a
repeat() in the Markdown serializer, unbounded.
Fall back when rendering rather than when reading, so that a value
written through collaborative editing, which does not run the attribute
validators, is covered too.
* fix: Correct open depths when unwrapping a single table cell on copy
The transformCopied prop replaced the slice content with the cell's content
but kept the original open depths, which still counted the removed table,
row, and cell levels. The resulting slice claimed to be open deeper than its
content, so any drag of a selection made inside a table cell threw in
dropPoint as the drop cursor walked into it.
Fixes OUTLINE-CLOUD-99J
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* fix: Unwrap single header cells on copy too
Header cells use the header_cell table role, so they never matched the
single-cell check and kept the table wrapper on copy.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Render React node views in server-side HTML export
Passes nodeViews to the headless EditorView used for export so that nodes
with a React component render with it, matching the editor, and falling
back to toDOM when a component cannot render server-side.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* Let nodes opt out of component rendering in static HTML
Replaces the hardcoded set of node names in the server nodeViews factory with
an allowComponentInStaticHTML getter on Extension, so a node declares the
behavior alongside its own definition rather than in a server file that does
not know about it.
Mention opts out: its component requires stores and a router, so it always
threw and fell back to toDOM, at the cost of a React render, an exception and
a log line per node. A document with 100 mentions now exports in ~12ms rather
than ~25ms and emits no warnings.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Yield one less macrotask turn when flushing React effects
Only two turns are needed: the first flushes passive effects, the second fires
Frame's own setTimeout(0) whose setState commits the iframe. The third turn
absorbed nothing that the components produce.
Each turn is roughly a millisecond of idle time held inside the render lock, on
every export — including plain documents, share page SSR and notification
emails — so dropping it takes a small export from ~6ms to ~4ms.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
* fix: Serialize external mentions as links in exported markdown
GitHub issue, pull request and project mentions carry the real URL in
`href`, but always serialized to a mention:// reference that cannot be
resolved outside of Outline. Write a plain link instead when the
commonMark serializer option is set, and set that option on the paths
where markdown leaves the platform – document and revision export, zip
exports, and the public share markdown response.
* Sanitize external mention url before navigation
Every remote change is applied as a full document replacement, which
invalidates the column resize handle while the drag is still active.
Releasing the pointer then resolved position -1 and threw.
Cancel the drag when the handle no longer points at a cell.
Fixes OUTLINE-CLOUD-B3R