⭐️⭐️⭐️ Open-source, self-hosted alternative to Linear and Plane. Project management and issue tracking where teams and AI agents work side by side to plan and ship products.
TypeScript agenticagileai-agentsbug-reportingbug-trackerganttissue-trackerjirajira-alternativekanbanlinearlinear-alternativeopen-sourceproduct-managementproject-managementroadmapself-hostedsprint-planningteam-collaborationtrello-alternative
import Image from '@tiptap/extension-image';
import { ReactNodeViewRenderer } from '@tiptap/react';
import EditorResizableImage from './EditorResizableImage';
import { allowedImageStyle } from '@/utils/imageStyle';
// Safe inside a double-quoted HTML attribute: a filename may hold any of these.
const escapeAttribute = (value: string) =>
value.replaceAll('&', '&').replaceAll('"', '"').replaceAll('<', '<');
// The backslash is escaped alongside the delimiters: without it `a\)b` serializes
// as `a\\)b`, where the `)` is no longer escaped and ends the URL early.
function markdownImage(src: string, alt: string, title: string | null): string {
const escapedAlt = alt.replaceAll(/[[\]\\]/g, '\\$&');
const escapedSrc = src.replaceAll(/[\\()]/g, '\\$&');
const escapedTitle = title ? ` "${title.replaceAll(/["\\]/g, '\\$&')}"` : '';
return ``;
}
// Neither the width nor an embed's `style` fits `` syntax, so an image
// carrying either serializes as a raw <img> tag (tiptap-markdown runs html:true).
export const ResizableImage = Image.extend({
addAttributes() {
// The image keeps height:auto and nothing ever sets the inherited height, so
// it is dropped: it would otherwise reach the document JSON as `height: null`,
// which the API rejects as an unsupported image attr.
const { height: _height, ...parent }: Record<string, unknown> = this.parent?.() ?? {};
return {
...parent,
// Kept so a raw <img style="max-width:50%"> keeps its sizing.
style: {
default: null,
parseHTML: (element) => allowedImageStyle(element.getAttribute('style')),
},
width: {
default: null,
parseHTML: (element) => {
const width = Number.parseInt(element.getAttribute('width') ?? '', 10);
return Number.isNaN(width) ? null : width;
},
renderHTML: (attributes) => (attributes.width ? { width: attributes.width } : {}),
},
};
},
addNodeView() {
return ReactNodeViewRenderer(EditorResizableImage);
},
addStorage() {
return {
markdown: {
serialize(
state: { write: (text: string) => void },
node: {
attrs: { src?: string; alt?: string; title?: string; width?: number; style?: string };
},
) {
const src = node.attrs.src ?? '';
const alt = node.attrs.alt ?? '';
const title = node.attrs.title ?? null;
const { width, style } = node.attrs;
if (!width && !style) {
state.write(markdownImage(src, alt, title));
return;
}
const titleAttribute = title ? ` title="${escapeAttribute(title)}"` : '';
const widthAttribute = width ? ` width="${width}"` : '';
const styleAttribute = style ? ` style="${escapeAttribute(style)}"` : '';
state.write(
`<img src="${escapeAttribute(src)}" alt="${escapeAttribute(alt)}"${titleAttribute}${widthAttribute}${styleAttribute}>`,
);
},
parse: {},
},
};
},
});