mardora 1.2.0

package/dist/plugins/index.js

@@ -0,0 +1,7 @@
+export { CODE_COPY_SUCCESS_ICON, CodePlugin, EmojiPlugin, HRPlugin, HTMLPlugin, HeadingPlugin, ImagePlugin, InlinePlugin, LinkPlugin, ListPlugin, MathPlugin, MermaidPlugin, ParagraphPlugin, QuotePlugin, TablePlugin, allPlugins, bindCodeCopyButtons, copyCodeTextToClipboard, decodeCodeCopyPayload, encodeCodeCopyPayload, essentialPlugins, resolveCalloutTitleInputTarget, resolveCalloutTypeChange } from '../chunk-3OCUX4OO.js';
+import '../chunk-XL6WFGJT.js';
+import '../chunk-BIKZQZ6W.js';
+import '../chunk-EQJESPP2.js';
+import '../chunk-P7JFCYU3.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/preview/index.cjs

@@ -0,0 +1,38 @@
+'use strict';
+
+var chunk3ZOCCFDL_cjs = require('../chunk-3ZOCCFDL.cjs');
+var chunkSWFUKJDO_cjs = require('../chunk-SWFUKJDO.cjs');
+require('../chunk-WFVCG4LD.cjs');
+
+
+
+Object.defineProperty(exports, "extractPreviewTocFromMarkdown", {
+  enumerable: true,
+  get: function () { return chunk3ZOCCFDL_cjs.extractPreviewTocFromMarkdown; }
+});
+Object.defineProperty(exports, "generateCSS", {
+  enumerable: true,
+  get: function () { return chunk3ZOCCFDL_cjs.generateCSS; }
+});
+Object.defineProperty(exports, "preview", {
+  enumerable: true,
+  get: function () { return chunk3ZOCCFDL_cjs.preview; }
+});
+Object.defineProperty(exports, "PreviewRenderer", {
+  enumerable: true,
+  get: function () { return chunkSWFUKJDO_cjs.PreviewRenderer; }
+});
+Object.defineProperty(exports, "defaultRenderers", {
+  enumerable: true,
+  get: function () { return chunkSWFUKJDO_cjs.defaultRenderers; }
+});
+Object.defineProperty(exports, "escapeHtml", {
+  enumerable: true,
+  get: function () { return chunkSWFUKJDO_cjs.escapeHtml; }
+});
+Object.defineProperty(exports, "generateSyntaxThemeCSS", {
+  enumerable: true,
+  get: function () { return chunkSWFUKJDO_cjs.generateSyntaxThemeCSS; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/preview/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/preview/index.d.cts

@@ -0,0 +1,101 @@
+import { P as PreviewConfig, G as GenerateCSSConfig, S as SyntaxThemeInput, a as NodeRendererMap } from '../types-NBsaxl4d.cjs';
+export { N as NodeRenderer, b as PreviewContext } from '../types-NBsaxl4d.cjs';
+import { MarkdownConfig } from '@lezer/markdown';
+import { y as MardoraTocConfig, z as MardoraTocItem, q as MardoraPlugin, a3 as ThemeEnum } from '../mardora-DCwjomil.cjs';
+import '@lezer/highlight';
+import '@codemirror/state';
+import '@codemirror/language';
+import '@lezer/common';
+import '@codemirror/view';
+import 'style-mod';
+
+/**
+ * Render markdown to semantic HTML
+ *
+ * @param markdown - Markdown string to render
+ * @param config - Preview configuration
+ * @returns HTML string
+ *
+ * @example
+ * ```ts
+ * import { preview } from 'mardora/preview';
+ * import { HeadingPlugin, ListPlugin } from 'mardora/plugins';
+ *
+ * const html = preview('# Hello World', {
+ *   plugins: [new HeadingPlugin(), new ListPlugin()],
+ *   wrapperClass: 'mardora-preview',
+ * });
+ * ```
+ */
+declare function preview(markdown: string, config?: PreviewConfig): Promise<string>;
+
+/**
+ * Generate CSS for preview rendering
+ *
+ * @param config - CSS generation configuration
+ * @returns CSS string
+ *
+ * @example
+ * ```ts
+ * import { generateCSS } from 'mardora/preview';
+ * import { HeadingPlugin, ListPlugin } from 'mardora/plugins';
+ *
+ * const css = generateCSS({
+ *   plugins: [new HeadingPlugin(), new ListPlugin()],
+ *   theme: ThemeEnum.AUTO,
+ *   includeBase: true,
+ * });
+ * ```
+ */
+declare function generateCSS(config?: GenerateCSSConfig): string;
+
+/**
+ * Extract syntax highlight CSS from resolved CodeMirror HighlightStyle modules.
+ */
+declare function generateSyntaxThemeCSS(syntaxTheme: SyntaxThemeInput | SyntaxThemeInput[] | undefined, _wrapperClass: string): string;
+
+declare function extractPreviewTocFromMarkdown(doc: string, config?: MardoraTocConfig, markdownConfig?: MarkdownConfig[]): MardoraTocItem[];
+
+/**
+ * Escape HTML special characters
+ */
+declare function escapeHtml(text: string): string;
+/**
+ * Default node renderers for all markdown node types
+ */
+declare const defaultRenderers: NodeRendererMap;
+
+/**
+ * Renderer class that walks the syntax tree and produces HTML
+ */
+declare class PreviewRenderer {
+    private doc;
+    private theme;
+    private plugins;
+    private markdown;
+    private sanitizeHtml;
+    private syntaxTheme;
+    private renderers;
+    private ctx;
+    private nodeToPlugins;
+    constructor(doc: string, plugins: MardoraPlugin[] | undefined, markdown: MarkdownConfig[], theme?: ThemeEnum, sanitize?: boolean, syntaxTheme?: SyntaxThemeInput | SyntaxThemeInput[]);
+    /**
+     * Build a map from node names to plugins that handle them
+     */
+    private buildNodePluginMap;
+    /**
+     * Render the document to HTML
+     */
+    render(): Promise<string>;
+    /**
+     * Render a single node to HTML
+     */
+    private renderNode;
+    private renderNodeWithExtent;
+    /**
+     * Render all children of a node, including text between nodes
+     */
+    private renderChildren;
+}
+
+export { GenerateCSSConfig, NodeRendererMap, PreviewConfig, PreviewRenderer, SyntaxThemeInput, defaultRenderers, escapeHtml, extractPreviewTocFromMarkdown, generateCSS, generateSyntaxThemeCSS, preview };

package/dist/preview/index.d.ts

@@ -0,0 +1,101 @@
+import { P as PreviewConfig, G as GenerateCSSConfig, S as SyntaxThemeInput, a as NodeRendererMap } from '../types-Pw2SWWAR.js';
+export { N as NodeRenderer, b as PreviewContext } from '../types-Pw2SWWAR.js';
+import { MarkdownConfig } from '@lezer/markdown';
+import { y as MardoraTocConfig, z as MardoraTocItem, q as MardoraPlugin, a3 as ThemeEnum } from '../mardora-DCwjomil.js';
+import '@lezer/highlight';
+import '@codemirror/state';
+import '@codemirror/language';
+import '@lezer/common';
+import '@codemirror/view';
+import 'style-mod';
+
+/**
+ * Render markdown to semantic HTML
+ *
+ * @param markdown - Markdown string to render
+ * @param config - Preview configuration
+ * @returns HTML string
+ *
+ * @example
+ * ```ts
+ * import { preview } from 'mardora/preview';
+ * import { HeadingPlugin, ListPlugin } from 'mardora/plugins';
+ *
+ * const html = preview('# Hello World', {
+ *   plugins: [new HeadingPlugin(), new ListPlugin()],
+ *   wrapperClass: 'mardora-preview',
+ * });
+ * ```
+ */
+declare function preview(markdown: string, config?: PreviewConfig): Promise<string>;
+
+/**
+ * Generate CSS for preview rendering
+ *
+ * @param config - CSS generation configuration
+ * @returns CSS string
+ *
+ * @example
+ * ```ts
+ * import { generateCSS } from 'mardora/preview';
+ * import { HeadingPlugin, ListPlugin } from 'mardora/plugins';
+ *
+ * const css = generateCSS({
+ *   plugins: [new HeadingPlugin(), new ListPlugin()],
+ *   theme: ThemeEnum.AUTO,
+ *   includeBase: true,
+ * });
+ * ```
+ */
+declare function generateCSS(config?: GenerateCSSConfig): string;
+
+/**
+ * Extract syntax highlight CSS from resolved CodeMirror HighlightStyle modules.
+ */
+declare function generateSyntaxThemeCSS(syntaxTheme: SyntaxThemeInput | SyntaxThemeInput[] | undefined, _wrapperClass: string): string;
+
+declare function extractPreviewTocFromMarkdown(doc: string, config?: MardoraTocConfig, markdownConfig?: MarkdownConfig[]): MardoraTocItem[];
+
+/**
+ * Escape HTML special characters
+ */
+declare function escapeHtml(text: string): string;
+/**
+ * Default node renderers for all markdown node types
+ */
+declare const defaultRenderers: NodeRendererMap;
+
+/**
+ * Renderer class that walks the syntax tree and produces HTML
+ */
+declare class PreviewRenderer {
+    private doc;
+    private theme;
+    private plugins;
+    private markdown;
+    private sanitizeHtml;
+    private syntaxTheme;
+    private renderers;
+    private ctx;
+    private nodeToPlugins;
+    constructor(doc: string, plugins: MardoraPlugin[] | undefined, markdown: MarkdownConfig[], theme?: ThemeEnum, sanitize?: boolean, syntaxTheme?: SyntaxThemeInput | SyntaxThemeInput[]);
+    /**
+     * Build a map from node names to plugins that handle them
+     */
+    private buildNodePluginMap;
+    /**
+     * Render the document to HTML
+     */
+    render(): Promise<string>;
+    /**
+     * Render a single node to HTML
+     */
+    private renderNode;
+    private renderNodeWithExtent;
+    /**
+     * Render all children of a node, including text between nodes
+     */
+    private renderChildren;
+}
+
+export { GenerateCSSConfig, NodeRendererMap, PreviewConfig, PreviewRenderer, SyntaxThemeInput, defaultRenderers, escapeHtml, extractPreviewTocFromMarkdown, generateCSS, generateSyntaxThemeCSS, preview };

package/dist/preview/index.js

@@ -0,0 +1,5 @@
+export { extractPreviewTocFromMarkdown, generateCSS, preview } from '../chunk-G4SE26YY.js';
+export { PreviewRenderer, defaultRenderers, escapeHtml, generateSyntaxThemeCSS } from '../chunk-EQJESPP2.js';
+import '../chunk-P7JFCYU3.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/preview/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/types-NBsaxl4d.d.cts

@@ -0,0 +1,71 @@
+import * as _lezer_markdown from '@lezer/markdown';
+import { q as MardoraPlugin, a3 as ThemeEnum } from './mardora-DCwjomil.cjs';
+import * as _lezer_highlight from '@lezer/highlight';
+import * as _codemirror_state from '@codemirror/state';
+import * as _codemirror_language from '@codemirror/language';
+import { SyntaxNode } from '@lezer/common';
+
+type SyntaxThemeInput = _codemirror_language.HighlightStyle | _codemirror_state.Extension | readonly _codemirror_state.Extension[];
+/**
+ * Context passed to plugin preview methods
+ */
+interface PreviewContext {
+    /** Full document text */
+    readonly doc: string;
+    /** Current theme */
+    readonly theme: ThemeEnum;
+    /** Slice document text between positions */
+    sliceDoc(from: number, to: number): string;
+    /** Sanitize HTML content (for HTMLBlock/HTMLTag) */
+    sanitize(html: string): string;
+    /** Render children of a node to HTML */
+    renderChildren(node: SyntaxNode): Promise<string>;
+    /** Active syntax highlighters used for code rendering */
+    readonly syntaxHighlighters?: readonly _lezer_highlight.Highlighter[];
+    /** Return a stable heading id for TOC-aware heading renderers */
+    headingIdForNode?(node: SyntaxNode): string | null;
+}
+/**
+ * Configuration for the preview renderer
+ */
+interface PreviewConfig {
+    /** Plugins to use for rendering */
+    plugins?: MardoraPlugin[];
+    /** Markdown extensions to use for rendering */
+    markdown?: _lezer_markdown.MarkdownConfig[];
+    /** CSS class for the wrapper element */
+    wrapperClass?: string;
+    /** HTML tag for the wrapper element */
+    wrapperTag?: "article" | "div" | "section";
+    /** Whether to sanitize HTML blocks (default: true) */
+    sanitize?: boolean;
+    /** Theme to use */
+    theme?: ThemeEnum;
+    /** CodeMirror syntax theme input used for static preview highlighting */
+    syntaxTheme?: SyntaxThemeInput | SyntaxThemeInput[];
+}
+/**
+ * Result of CSS generation
+ */
+interface GenerateCSSConfig {
+    /** Plugins to extract styles from */
+    plugins?: MardoraPlugin[];
+    /** Theme to use */
+    theme?: ThemeEnum;
+    /** Wrapper class for scoping (default: "mardora-preview") */
+    wrapperClass?: string;
+    /** Include base styles */
+    includeBase?: boolean;
+    /** CodeMirror syntax theme input used for static preview syntax highlighting */
+    syntaxTheme?: SyntaxThemeInput | SyntaxThemeInput[];
+}
+/**
+ * Node renderer function type
+ */
+type NodeRenderer = (node: SyntaxNode, children: string, ctx: PreviewContext) => string;
+/**
+ * Map of node names to their renderers
+ */
+type NodeRendererMap = Record<string, NodeRenderer>;
+
+export type { GenerateCSSConfig as G, NodeRenderer as N, PreviewConfig as P, SyntaxThemeInput as S, NodeRendererMap as a, PreviewContext as b };

package/dist/types-Pw2SWWAR.d.ts

@@ -0,0 +1,71 @@
+import * as _lezer_markdown from '@lezer/markdown';
+import { q as MardoraPlugin, a3 as ThemeEnum } from './mardora-DCwjomil.js';
+import * as _lezer_highlight from '@lezer/highlight';
+import * as _codemirror_state from '@codemirror/state';
+import * as _codemirror_language from '@codemirror/language';
+import { SyntaxNode } from '@lezer/common';
+
+type SyntaxThemeInput = _codemirror_language.HighlightStyle | _codemirror_state.Extension | readonly _codemirror_state.Extension[];
+/**
+ * Context passed to plugin preview methods
+ */
+interface PreviewContext {
+    /** Full document text */
+    readonly doc: string;
+    /** Current theme */
+    readonly theme: ThemeEnum;
+    /** Slice document text between positions */
+    sliceDoc(from: number, to: number): string;
+    /** Sanitize HTML content (for HTMLBlock/HTMLTag) */
+    sanitize(html: string): string;
+    /** Render children of a node to HTML */
+    renderChildren(node: SyntaxNode): Promise<string>;
+    /** Active syntax highlighters used for code rendering */
+    readonly syntaxHighlighters?: readonly _lezer_highlight.Highlighter[];
+    /** Return a stable heading id for TOC-aware heading renderers */
+    headingIdForNode?(node: SyntaxNode): string | null;
+}
+/**
+ * Configuration for the preview renderer
+ */
+interface PreviewConfig {
+    /** Plugins to use for rendering */
+    plugins?: MardoraPlugin[];
+    /** Markdown extensions to use for rendering */
+    markdown?: _lezer_markdown.MarkdownConfig[];
+    /** CSS class for the wrapper element */
+    wrapperClass?: string;
+    /** HTML tag for the wrapper element */
+    wrapperTag?: "article" | "div" | "section";
+    /** Whether to sanitize HTML blocks (default: true) */
+    sanitize?: boolean;
+    /** Theme to use */
+    theme?: ThemeEnum;
+    /** CodeMirror syntax theme input used for static preview highlighting */
+    syntaxTheme?: SyntaxThemeInput | SyntaxThemeInput[];
+}
+/**
+ * Result of CSS generation
+ */
+interface GenerateCSSConfig {
+    /** Plugins to extract styles from */
+    plugins?: MardoraPlugin[];
+    /** Theme to use */
+    theme?: ThemeEnum;
+    /** Wrapper class for scoping (default: "mardora-preview") */
+    wrapperClass?: string;
+    /** Include base styles */
+    includeBase?: boolean;
+    /** CodeMirror syntax theme input used for static preview syntax highlighting */
+    syntaxTheme?: SyntaxThemeInput | SyntaxThemeInput[];
+}
+/**
+ * Node renderer function type
+ */
+type NodeRenderer = (node: SyntaxNode, children: string, ctx: PreviewContext) => string;
+/**
+ * Map of node names to their renderers
+ */
+type NodeRendererMap = Record<string, NodeRenderer>;
+
+export type { GenerateCSSConfig as G, NodeRenderer as N, PreviewConfig as P, SyntaxThemeInput as S, NodeRendererMap as a, PreviewContext as b };

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "mardora",
+  "version": "1.2.0",
+  "description": "Core library for Mardora",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Refinex-Space/mardora.git",
+    "directory": "packages/mardora"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test tests"
+  },
+  "devDependencies": {
+    "@turbo/gen": "^2.7.6",
+    "@types/dompurify": "^3.2.0",
+    "@types/node": "^25.0.10",
+    "@workspace/eslint-config": "workspace:*",
+    "@workspace/typescript-config": "workspace:*",
+    "eslint": "^9.39.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@codemirror/commands": "6.10.3",
+    "@codemirror/lang-markdown": "6.5.0",
+    "@codemirror/language": "6.12.3",
+    "@codemirror/language-data": "6.5.2",
+    "@codemirror/state": "6.6.0",
+    "@codemirror/view": "6.43.1",
+    "@lezer/common": "1.5.2",
+    "@lezer/highlight": "1.2.3",
+    "@lezer/markdown": "1.6.4",
+    "dompurify": "^3.3.1",
+    "katex": "^0.16.28",
+    "mermaid": "11.12.2",
+    "node-emoji": "^2.2.0",
+    "style-mod": "^4.1.3",
+    "zod": "^4.3.6"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./editor": {
+      "types": "./dist/editor/index.d.ts",
+      "import": "./dist/editor/index.js",
+      "require": "./dist/editor/index.cjs",
+      "default": "./dist/editor/index.js"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/index.d.ts",
+      "import": "./dist/plugins/index.js",
+      "require": "./dist/plugins/index.cjs",
+      "default": "./dist/plugins/index.js"
+    },
+    "./preview": {
+      "types": "./dist/preview/index.d.ts",
+      "import": "./dist/preview/index.js",
+      "require": "./dist/preview/index.cjs",
+      "default": "./dist/preview/index.js"
+    },
+    "./lib": {
+      "types": "./dist/lib/index.d.ts",
+      "import": "./dist/lib/index.js",
+      "require": "./dist/lib/index.cjs",
+      "default": "./dist/lib/index.js"
+    },
+    "./src": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./src/*": "./src/*"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/editor/attachments/extension.ts

@@ -0,0 +1,181 @@
+import { Extension } from "@codemirror/state";
+import { EditorView } from "@codemirror/view";
+import { createUploadMarker, detectAttachmentKind, formatAttachmentMarkdown, isAcceptedAttachment } from "./format";
+import type {
+  MardoraAttachmentKind,
+  MardoraAttachmentsConfig,
+  MardoraAttachmentUploadSource,
+  MardoraAttachmentUploader,
+} from "./types";
+
+let uploadSequence = 0;
+
+export type MardoraAttachmentEditorView = {
+  state: {
+    doc: {
+      length: number;
+      toString(): string;
+      lineAt(position: number): { from: number; to: number };
+    };
+    selection: {
+      main: { from: number; to: number };
+    };
+  };
+  dispatch(spec: {
+    changes?: { from: number; to?: number; insert?: string } | Array<{ from: number; to?: number; insert?: string }>;
+    selection?: { anchor: number };
+    scrollIntoView?: boolean;
+  }): void;
+  focus?(): void;
+};
+
+export type MardoraUploadAttachmentOptions = {
+  kind?: MardoraAttachmentKind;
+  source: MardoraAttachmentUploadSource;
+  range?: { from: number; to: number };
+  uploader: MardoraAttachmentUploader;
+};
+
+function nextUploadTaskId(): string {
+  uploadSequence += 1;
+  return `task-${Date.now()}-${uploadSequence}`;
+}
+
+function findMarkerRange(view: MardoraAttachmentEditorView, taskId: string): { from: number; to: number } | null {
+  const doc = view.state.doc.toString();
+  const marker = `mardora-upload://${taskId}`;
+  const markerIndex = doc.indexOf(marker);
+
+  if (markerIndex === -1) {
+    return null;
+  }
+
+  const line = view.state.doc.lineAt(markerIndex);
+  return { from: line.from, to: line.to };
+}
+
+export async function uploadAttachmentFile(
+  view: MardoraAttachmentEditorView,
+  file: File,
+  options: MardoraUploadAttachmentOptions
+): Promise<void> {
+  const kind = options.kind ?? detectAttachmentKind(file);
+  const range = options.range ?? {
+    from: view.state.selection.main.from,
+    to: view.state.selection.main.to,
+  };
+  const taskId = nextUploadTaskId();
+  const marker = createUploadMarker({ taskId, kind, name: file.name, state: "uploading" });
+
+  view.dispatch({
+    changes: { from: range.from, to: range.to, insert: marker },
+    selection: { anchor: range.from + marker.length },
+    scrollIntoView: true,
+  });
+
+  try {
+    const result = await options.uploader(file, {
+      kind,
+      source: options.source,
+      documentText: view.state.doc.toString(),
+      selection: { from: range.from, to: range.from + marker.length },
+    });
+    const markerRange = findMarkerRange(view, taskId);
+
+    if (!markerRange) {
+      return;
+    }
+
+    const output = formatAttachmentMarkdown(kind, {
+      ...result,
+      name: result.name ?? file.name,
+      mimeType: result.mimeType ?? file.type,
+    });
+
+    view.dispatch({
+      changes: { from: markerRange.from, to: markerRange.to, insert: output },
+      selection: { anchor: markerRange.from + output.length },
+      scrollIntoView: true,
+    });
+  } catch {
+    const markerRange = findMarkerRange(view, taskId);
+
+    if (!markerRange) {
+      return;
+    }
+
+    const failedMarker = createUploadMarker({ taskId, kind, name: file.name, state: "failed" });
+    view.dispatch({
+      changes: { from: markerRange.from, to: markerRange.to, insert: failedMarker },
+      selection: { anchor: markerRange.from + failedMarker.length },
+      scrollIntoView: true,
+    });
+  }
+}
+
+function getFilesFromEvent(event: ClipboardEvent | DragEvent): File[] {
+  const files =
+    event.type === "paste" ? (event as ClipboardEvent).clipboardData?.files : (event as DragEvent).dataTransfer?.files;
+  return files ? Array.from(files) : [];
+}
+
+function uploadFilesFromEvent(
+  view: EditorView,
+  event: ClipboardEvent | DragEvent,
+  source: MardoraAttachmentUploadSource,
+  config: Required<Pick<MardoraAttachmentsConfig, "uploader">> & MardoraAttachmentsConfig
+): boolean {
+  const files = getFilesFromEvent(event);
+  if (files.length === 0) {
+    return false;
+  }
+
+  event.preventDefault();
+
+  for (const file of files) {
+    const kind = detectAttachmentKind(file);
+    const acceptRules = config.accept?.[kind] ?? ["*/*"];
+
+    if (!isAcceptedAttachment(file, acceptRules)) {
+      continue;
+    }
+
+    void uploadAttachmentFile(view, file, {
+      kind,
+      source,
+      uploader: config.uploader,
+    });
+  }
+
+  return true;
+}
+
+export function attachments(config: MardoraAttachmentsConfig = {}): Extension[] {
+  if (config.enabled === false || !config.uploader) {
+    return [];
+  }
+
+  const normalizedConfig = {
+    enablePaste: true,
+    enableDrop: true,
+    ...config,
+    uploader: config.uploader,
+  };
+
+  return [
+    EditorView.domEventHandlers({
+      paste(event, view) {
+        if (!normalizedConfig.enablePaste) {
+          return false;
+        }
+        return uploadFilesFromEvent(view, event, "paste", normalizedConfig);
+      },
+      drop(event, view) {
+        if (!normalizedConfig.enableDrop) {
+          return false;
+        }
+        return uploadFilesFromEvent(view, event, "drop", normalizedConfig);
+      },
+    }),
+  ];
+}