Files
Tom Moor 27f7bda660 chore: Upgrade styled-components from v5 to v6 (#14047)
* chore: Upgrade styled-components to v6

* fix: Keep pseudo-selectors attached to their parent under stylis 4
2026-10-11 21:46:38 -04:00

141 lines
4.7 KiB
TypeScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import type { Node as ProsemirrorNode } from "prosemirror-model";
import type { Decoration, EditorView, NodeView } from "prosemirror-view";
import type { FunctionComponent } from "react";
import { flushSync } from "react-dom";
import type { Root } from "react-dom/client";
import { createRoot } from "react-dom/client";
import { type ServerStyleSheet, ThemeProvider } from "styled-components";
import { StyleSheetProvider } from "@shared/components/StyleSheetProvider";
import type { ComponentProps } from "@shared/editor/types";
import light from "@shared/styles/theme";
type ComponentViewOptions = {
/** The node the view is responsible for. */
node: ProsemirrorNode;
/** The editor view instance. */
view: EditorView;
/** A function that returns the current position of the node. */
getPos: () => number | undefined;
/** The decorations applied to the node. */
decorations: readonly Decoration[];
/** The per-export styled-components sheet collecting the component's styles. */
sheet: ServerStyleSheet;
};
/**
* Server-side ProseMirror NodeView that renders a node's React `component` –
* the same one used in the browser – into a headless jsdom document, so HTML
* export matches the in-app rendering. Rendering is forced synchronous with
* flushSync; content-bearing nodes expose a `contentDOM` hole that ProseMirror
* fills, while leaf nodes render entirely from React.
*/
export class ComponentView implements NodeView {
/** The DOM element the node is rendered into. */
public dom: HTMLElement;
/** The element ProseMirror-managed child content is mounted within, if any. */
public contentDOM?: HTMLElement;
private node: ProsemirrorNode;
private decorations: readonly Decoration[];
private className: string;
private root: Root;
constructor(
component: FunctionComponent<Omit<ComponentProps, "theme">>,
{ node, view, getPos, decorations, sheet }: ComponentViewOptions
) {
this.node = node;
this.decorations = decorations;
const tag = node.type.spec.inline ? "span" : "div";
this.dom = document.createElement(tag);
if (!node.isLeaf) {
this.contentDOM = document.createElement(tag);
}
this.className = `component-${node.type.name}`;
this.dom.classList.add(this.className);
this.applyDecorationClasses();
// Theme is delivered via ThemeProvider context per ReactNode's
// `Omit<ComponentProps, "theme">` contract.
const props: Omit<ComponentProps, "theme"> = {
node,
view,
isSelected: false,
isEditable: false,
getPos: () => getPos() ?? 0,
decorations: [...decorations],
contentRef: this.handleContentRef,
};
const Component = component;
this.root = createRoot(this.dom);
// flushSync guarantees the mount commits before the constructor returns;
// a plain root.render() is asynchronous and the export path reads the DOM
// immediately after.
flushSync(() => {
this.root.render(
<StyleSheetProvider sheet={sheet.instance}>
<ThemeProvider theme={light}>
<Component {...props} />
</ThemeProvider>
</StyleSheetProvider>
);
});
}
/**
* The document is static, so never reuse a view for a changed node; forcing
* re-creation keeps the render pure. Returning false also stops ProseMirror's
* DOMObserver from reacting to late passive-effect renders.
*/
public update(): boolean {
return false;
}
/** Ignore all mutations so late React effect renders don't disturb ProseMirror. */
public ignoreMutation(): boolean {
return true;
}
/** Unmount the React tree, clearing any timers the component scheduled. */
public destroy(): void {
this.root.unmount();
}
/**
* Apply decoration classes (e.g. revision diff markers) to the DOM element,
* extracting them from inline decorations that overlap this node's position.
*/
private applyDecorationClasses(): void {
this.decorations.forEach((decoration) => {
const attrs = (
decoration as Decoration & { type?: { attrs?: { class?: string } } }
).type?.attrs;
if (attrs?.class) {
attrs.class.split(" ").forEach((className) => {
if (className) {
this.dom.classList.add(className);
}
});
}
});
}
/**
* Ref callback marking the element ProseMirror-managed content is mounted
* within. The render is wrapped in flushSync, so `contentDOM` is attached
* before the constructor returns.
*/
private handleContentRef = (element: HTMLElement | null) => {
if (
element &&
this.contentDOM &&
element !== this.contentDOM.parentElement
) {
element.appendChild(this.contentDOM);
}
};
}