@pixerate/editor 0.18.0 → 0.20.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/controller.ts","../src/dirty.ts"],"sourcesContent":["import { Editor, EditorOptions, Content, Extensions } from \"@tiptap/core\";\nimport { Slice } from \"@tiptap/pm/model\";\nimport { Token, tokenizePrompt } from \"./grammar\";\nimport {\n  plainTextToTipTapHtml,\n  plainTextToSlice,\n  getEditorText,\n  markdownToTipTapHtml,\n  getEditorMarkdown,\n} from \"./serializers\";\n\nexport interface EditorControllerOptions extends Partial<\n  Omit<EditorOptions, \"element\" | \"content\">\n> {\n  element?: Element | HTMLElement | null;\n  content?: string | Content;\n  plainTextMode?: boolean;\n  markdownMode?: boolean;\n  extensions?: Extensions;\n  onPlainTextChange?: (text: string) => void;\n  onMarkdownChange?: (markdown: string) => void;\n  onTokensChange?: (tokens: Token[]) => void;\n  onSelectionChange?: (range: { from: number; to: number } | null) => void;\n}\n\n/**\n * UI-agnostic controller managing the lifecycle, commands, and plain-text/token\n * synchronization of a rich text or prompt editor.\n */\nexport class EditorController {\n  public readonly editor: Editor;\n  private readonly plainTextMode: boolean;\n  private readonly markdownMode: boolean;\n  private readonly onPlainTextChange?: (text: string) => void;\n  private readonly onMarkdownChange?: (markdown: string) => void;\n  private readonly onTokensChange?: (tokens: Token[]) => void;\n  private readonly onSelectionChange?: (\n    range: { from: number; to: number } | null,\n  ) => void;\n  private baselineContent: string;\n\n  constructor(options: EditorControllerOptions = {}) {\n    const {\n      element,\n      content,\n      plainTextMode = false,\n      markdownMode = false,\n      extensions = [],\n      onPlainTextChange,\n      onMarkdownChange,\n      onTokensChange,\n      onSelectionChange,\n      ...editorOptions\n    } = options;\n\n    this.plainTextMode = plainTextMode;\n    this.markdownMode = markdownMode;\n    this.onPlainTextChange = onPlainTextChange;\n    this.onMarkdownChange = onMarkdownChange;\n    this.onTokensChange = onTokensChange;\n    this.onSelectionChange = onSelectionChange;\n\n    const initialContent =\n      plainTextMode && typeof content === \"string\"\n        ? plainTextToTipTapHtml(content)\n        : markdownMode && typeof content === \"string\"\n          ? markdownToTipTapHtml(content)\n          : content;\n\n    this.editor = new Editor({\n      element: element || undefined,\n      content: initialContent,\n      extensions,\n      ...editorOptions,\n      onUpdate: (props) => {\n        editorOptions.onUpdate?.(props);\n        this.handleUpdate();\n      },\n      onSelectionUpdate: (props) => {\n        editorOptions.onSelectionUpdate?.(props);\n        this.handleSelectionUpdate();\n      },\n    });\n\n    if (plainTextMode) {\n      this.enforcePlainTextClipboard();\n    }\n\n    this.baselineContent = this.getCurrentContentString();\n  }\n\n  private enforcePlainTextClipboard() {\n    this.editor.setOptions({\n      editorProps: {\n        ...this.editor.options.editorProps,\n        clipboardTextParser: (\n          text: string,\n          context: any,\n          _plain: boolean,\n          view?: any,\n        ) => {\n          const schema =\n            context?.doc?.type?.schema ||\n            context?.schema ||\n            view?.state?.schema ||\n            this.editor.schema;\n\n          if (!schema) return Slice.empty;\n\n          return plainTextToSlice(text, schema);\n        },\n      },\n    });\n  }\n\n  private handleUpdate() {\n    if (this.plainTextMode || this.onPlainTextChange || this.onTokensChange) {\n      const text = this.getPlainText();\n      this.onPlainTextChange?.(text);\n\n      if (this.onTokensChange) {\n        const tokens = tokenizePrompt(text);\n        this.onTokensChange(tokens);\n      }\n    }\n\n    if (this.markdownMode || this.onMarkdownChange) {\n      const markdown = this.getMarkdown();\n      this.onMarkdownChange?.(markdown);\n    }\n  }\n\n  private handleSelectionUpdate() {\n    if (this.onSelectionChange) {\n      const { from, to } = this.editor.state.selection;\n      this.onSelectionChange({ from, to });\n    }\n  }\n\n  public getPlainText(): string {\n    return getEditorText(this.editor);\n  }\n\n  public setPlainText(text: string, emitUpdate = true) {\n    const html = plainTextToTipTapHtml(text);\n    this.editor.commands.setContent(html, emitUpdate);\n  }\n\n  public getMarkdown(): string {\n    return getEditorMarkdown(this.editor);\n  }\n\n  public setMarkdown(markdown: string, emitUpdate = true) {\n    if (this.editor.storage?.markdown?.parser) {\n      this.editor.commands.setContent(markdown, emitUpdate);\n    } else {\n      const html = markdownToTipTapHtml(markdown);\n      this.editor.commands.setContent(html, emitUpdate);\n    }\n  }\n\n  /**\n   * Replaces `from`..`to` with literal text: HTML in `text` is not parsed, and\n   * newlines split paragraphs.\n   */\n  private insertPlainText(from: number, to: number, text: string) {\n    const { state, view } = this.editor;\n    const tr = text.includes(\"\\n\") || text.includes(\"\\r\")\n      ? state.tr.replace(from, to, plainTextToSlice(text, state.schema))\n      : text\n        ? state.tr.insertText(text, from, to)\n        : state.tr.delete(from, to);\n    view.dispatch(tr.scrollIntoView());\n  }\n\n  /** Inserts text literally at the selection; HTML in `text` is not parsed. */\n  public insertText(text: string) {\n    const { from, to } = this.editor.state.selection;\n    this.insertPlainText(from, to, text);\n  }\n\n  /** Inserts text literally at `pos`; HTML in `text` is not parsed. */\n  public insertTextAt(pos: number, text: string) {\n    this.insertPlainText(pos, pos, text);\n    this.editor.commands.focus();\n  }\n\n  /** Replaces a range with literal text; HTML in `text` is not parsed. */\n  public replaceRange(from: number, to: number, text: string) {\n    this.insertPlainText(from, to, text);\n    this.editor.commands.focus();\n  }\n\n  public getCurrentContentString(): string {\n    if (this.plainTextMode) return this.getPlainText();\n    if (this.markdownMode) return this.getMarkdown();\n    return this.editor.getHTML();\n  }\n\n  public isDirty(): boolean {\n    return this.getCurrentContentString() !== this.baselineContent;\n  }\n\n  public setCheckpoint(content?: string): void {\n    this.baselineContent =\n      content !== undefined ? content : this.getCurrentContentString();\n  }\n\n  public resetDirty(): void {\n    this.setCheckpoint();\n  }\n\n  public getBaselineContent(): string {\n    return this.baselineContent;\n  }\n\n  public destroy() {\n    this.editor.destroy();\n  }\n}\n\n/**\n * Creates and initializes an EditorController instance.\n */\nexport function createEditor(\n  options: EditorControllerOptions = {},\n): EditorController {\n  return new EditorController(options);\n}\n","/**\n * Compares two values for structural equality.\n * Handles primitives, objects, arrays, and null/undefined.\n */\nexport function defaultIsEqual<T>(a: T, b: T): boolean {\n  if (Object.is(a, b)) return true;\n  if (\n    typeof a !== \"object\" ||\n    a === null ||\n    typeof b !== \"object\" ||\n    b === null\n  ) {\n    return false;\n  }\n\n  // Fast path for arrays\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false;\n    for (let i = 0; i < a.length; i++) {\n      if (!defaultIsEqual(a[i], b[i])) return false;\n    }\n    return true;\n  }\n  if (Array.isArray(a) !== Array.isArray(b)) {\n    return false;\n  }\n\n  const keysA = Object.keys(a) as (keyof T)[];\n  const keysB = Object.keys(b) as (keyof T)[];\n\n  if (keysA.length !== keysB.length) return false;\n\n  for (const key of keysA) {\n    if (!Object.prototype.hasOwnProperty.call(b, key)) return false;\n    if (!defaultIsEqual(a[key], b[key])) return false;\n  }\n\n  return true;\n}\n\nexport interface DirtyTrackerOptions<T> {\n  isEqual?: (a: T, b: T) => boolean;\n}\n\n/**\n * Tracks a baseline value and determines if the current state is dirty (modified).\n */\nexport class DirtyTracker<T = unknown> {\n  private baseline: T;\n  private readonly isEqual: (a: T, b: T) => boolean;\n\n  constructor(\n    initialBaseline: T,\n    options?: DirtyTrackerOptions<T> | ((a: T, b: T) => boolean),\n  ) {\n    this.baseline = initialBaseline;\n    if (typeof options === \"function\") {\n      this.isEqual = options;\n    } else {\n      this.isEqual = options?.isEqual ?? defaultIsEqual;\n    }\n  }\n\n  /**\n   * Returns current baseline value.\n   */\n  public getBaseline(): T {\n    return this.baseline;\n  }\n\n  /**\n   * Sets a new baseline value without triggering any dirty state.\n   */\n  public setBaseline(value: T): void {\n    this.baseline = value;\n  }\n\n  /**\n   * Checks whether the given value differs from the baseline.\n   */\n  public isDirty(current: T): boolean {\n    return !this.isEqual(this.baseline, current);\n  }\n\n  /**\n   * Resets the baseline to the provided current value (or clears dirty status).\n   */\n  public reset(current: T): void {\n    this.baseline = current;\n  }\n}\n\n/**\n * Creates a DirtyTracker instance.\n */\nexport function createDirtyTracker<T>(\n  initialBaseline: T,\n  options?: DirtyTrackerOptions<T> | ((a: T, b: T) => boolean),\n): DirtyTracker<T> {\n  return new DirtyTracker(initialBaseline, options);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/controller.ts","../src/dirty.ts","../src/import/controller.ts"],"sourcesContent":["import { Editor, EditorOptions, Content, Extensions } from \"@tiptap/core\";\nimport { Slice } from \"@tiptap/pm/model\";\nimport { Token, tokenizePrompt } from \"./grammar\";\nimport {\n  plainTextToTipTapHtml,\n  plainTextToSlice,\n  getEditorText,\n  markdownToTipTapHtml,\n  getEditorMarkdown,\n} from \"./serializers\";\n\nexport interface EditorControllerOptions extends Partial<\n  Omit<EditorOptions, \"element\" | \"content\">\n> {\n  element?: Element | HTMLElement | null;\n  content?: string | Content;\n  plainTextMode?: boolean;\n  markdownMode?: boolean;\n  extensions?: Extensions;\n  onPlainTextChange?: (text: string) => void;\n  onMarkdownChange?: (markdown: string) => void;\n  onTokensChange?: (tokens: Token[]) => void;\n  onSelectionChange?: (range: { from: number; to: number } | null) => void;\n}\n\n/**\n * UI-agnostic controller managing the lifecycle, commands, and plain-text/token\n * synchronization of a rich text or prompt editor.\n */\nexport class EditorController {\n  public readonly editor: Editor;\n  private readonly plainTextMode: boolean;\n  private readonly markdownMode: boolean;\n  private readonly onPlainTextChange?: (text: string) => void;\n  private readonly onMarkdownChange?: (markdown: string) => void;\n  private readonly onTokensChange?: (tokens: Token[]) => void;\n  private readonly onSelectionChange?: (\n    range: { from: number; to: number } | null,\n  ) => void;\n  private baselineContent: string;\n\n  constructor(options: EditorControllerOptions = {}) {\n    const {\n      element,\n      content,\n      plainTextMode = false,\n      markdownMode = false,\n      extensions = [],\n      onPlainTextChange,\n      onMarkdownChange,\n      onTokensChange,\n      onSelectionChange,\n      ...editorOptions\n    } = options;\n\n    this.plainTextMode = plainTextMode;\n    this.markdownMode = markdownMode;\n    this.onPlainTextChange = onPlainTextChange;\n    this.onMarkdownChange = onMarkdownChange;\n    this.onTokensChange = onTokensChange;\n    this.onSelectionChange = onSelectionChange;\n\n    const initialContent =\n      plainTextMode && typeof content === \"string\"\n        ? plainTextToTipTapHtml(content)\n        : markdownMode && typeof content === \"string\"\n          ? markdownToTipTapHtml(content)\n          : content;\n\n    this.editor = new Editor({\n      element: element || undefined,\n      content: initialContent,\n      extensions,\n      ...editorOptions,\n      onUpdate: (props) => {\n        editorOptions.onUpdate?.(props);\n        this.handleUpdate();\n      },\n      onSelectionUpdate: (props) => {\n        editorOptions.onSelectionUpdate?.(props);\n        this.handleSelectionUpdate();\n      },\n    });\n\n    if (plainTextMode) {\n      this.enforcePlainTextClipboard();\n    }\n\n    this.baselineContent = this.getCurrentContentString();\n  }\n\n  private enforcePlainTextClipboard() {\n    // Opt-in rich clipboard / file import must not bypass the plain-text invariant.\n    const richClipboard = this.editor.storage?.richClipboard;\n    if (richClipboard) richClipboard.plainTextMode = true;\n    const fileImport = this.editor.extensionManager?.extensions.find(\n      (ext) => ext.name === \"fileImport\",\n    );\n    if (fileImport) fileImport.options.asPlainText = true;\n\n    this.editor.setOptions({\n      editorProps: {\n        ...this.editor.options.editorProps,\n        clipboardTextParser: (\n          text: string,\n          context: any,\n          _plain: boolean,\n          view?: any,\n        ) => {\n          const schema =\n            context?.doc?.type?.schema ||\n            context?.schema ||\n            view?.state?.schema ||\n            this.editor.schema;\n\n          if (!schema) return Slice.empty;\n\n          return plainTextToSlice(text, schema);\n        },\n      },\n    });\n  }\n\n  private handleUpdate() {\n    if (this.plainTextMode || this.onPlainTextChange || this.onTokensChange) {\n      const text = this.getPlainText();\n      this.onPlainTextChange?.(text);\n\n      if (this.onTokensChange) {\n        const tokens = tokenizePrompt(text);\n        this.onTokensChange(tokens);\n      }\n    }\n\n    if (this.markdownMode || this.onMarkdownChange) {\n      const markdown = this.getMarkdown();\n      this.onMarkdownChange?.(markdown);\n    }\n  }\n\n  private handleSelectionUpdate() {\n    if (this.onSelectionChange) {\n      const { from, to } = this.editor.state.selection;\n      this.onSelectionChange({ from, to });\n    }\n  }\n\n  public getPlainText(): string {\n    return getEditorText(this.editor);\n  }\n\n  public setPlainText(text: string, emitUpdate = true) {\n    const html = plainTextToTipTapHtml(text);\n    this.editor.commands.setContent(html, emitUpdate);\n  }\n\n  public getMarkdown(): string {\n    return getEditorMarkdown(this.editor);\n  }\n\n  public setMarkdown(markdown: string, emitUpdate = true) {\n    if (this.editor.storage?.markdown?.parser) {\n      this.editor.commands.setContent(markdown, emitUpdate);\n    } else {\n      const html = markdownToTipTapHtml(markdown);\n      this.editor.commands.setContent(html, emitUpdate);\n    }\n  }\n\n  /**\n   * Replaces `from`..`to` with literal text: HTML in `text` is not parsed, and\n   * newlines split paragraphs.\n   */\n  private insertPlainText(from: number, to: number, text: string) {\n    const { state, view } = this.editor;\n    const tr = text.includes(\"\\n\") || text.includes(\"\\r\")\n      ? state.tr.replace(from, to, plainTextToSlice(text, state.schema))\n      : text\n        ? state.tr.insertText(text, from, to)\n        : state.tr.delete(from, to);\n    view.dispatch(tr.scrollIntoView());\n  }\n\n  /** Inserts text literally at the selection; HTML in `text` is not parsed. */\n  public insertText(text: string) {\n    const { from, to } = this.editor.state.selection;\n    this.insertPlainText(from, to, text);\n  }\n\n  /** Inserts text literally at `pos`; HTML in `text` is not parsed. */\n  public insertTextAt(pos: number, text: string) {\n    this.insertPlainText(pos, pos, text);\n    this.editor.commands.focus();\n  }\n\n  /** Replaces a range with literal text; HTML in `text` is not parsed. */\n  public replaceRange(from: number, to: number, text: string) {\n    this.insertPlainText(from, to, text);\n    this.editor.commands.focus();\n  }\n\n  public getCurrentContentString(): string {\n    if (this.plainTextMode) return this.getPlainText();\n    if (this.markdownMode) return this.getMarkdown();\n    return this.editor.getHTML();\n  }\n\n  public isDirty(): boolean {\n    return this.getCurrentContentString() !== this.baselineContent;\n  }\n\n  public setCheckpoint(content?: string): void {\n    this.baselineContent =\n      content !== undefined ? content : this.getCurrentContentString();\n  }\n\n  public resetDirty(): void {\n    this.setCheckpoint();\n  }\n\n  public getBaselineContent(): string {\n    return this.baselineContent;\n  }\n\n  public destroy() {\n    this.editor.destroy();\n  }\n}\n\n/**\n * Creates and initializes an EditorController instance.\n */\nexport function createEditor(\n  options: EditorControllerOptions = {},\n): EditorController {\n  return new EditorController(options);\n}\n","/**\n * Compares two values for structural equality.\n * Handles primitives, objects, arrays, and null/undefined.\n */\nexport function defaultIsEqual<T>(a: T, b: T): boolean {\n  if (Object.is(a, b)) return true;\n  if (\n    typeof a !== \"object\" ||\n    a === null ||\n    typeof b !== \"object\" ||\n    b === null\n  ) {\n    return false;\n  }\n\n  // Fast path for arrays\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false;\n    for (let i = 0; i < a.length; i++) {\n      if (!defaultIsEqual(a[i], b[i])) return false;\n    }\n    return true;\n  }\n  if (Array.isArray(a) !== Array.isArray(b)) {\n    return false;\n  }\n\n  const keysA = Object.keys(a) as (keyof T)[];\n  const keysB = Object.keys(b) as (keyof T)[];\n\n  if (keysA.length !== keysB.length) return false;\n\n  for (const key of keysA) {\n    if (!Object.prototype.hasOwnProperty.call(b, key)) return false;\n    if (!defaultIsEqual(a[key], b[key])) return false;\n  }\n\n  return true;\n}\n\nexport interface DirtyTrackerOptions<T> {\n  isEqual?: (a: T, b: T) => boolean;\n}\n\n/**\n * Tracks a baseline value and determines if the current state is dirty (modified).\n */\nexport class DirtyTracker<T = unknown> {\n  private baseline: T;\n  private readonly isEqual: (a: T, b: T) => boolean;\n\n  constructor(\n    initialBaseline: T,\n    options?: DirtyTrackerOptions<T> | ((a: T, b: T) => boolean),\n  ) {\n    this.baseline = initialBaseline;\n    if (typeof options === \"function\") {\n      this.isEqual = options;\n    } else {\n      this.isEqual = options?.isEqual ?? defaultIsEqual;\n    }\n  }\n\n  /**\n   * Returns current baseline value.\n   */\n  public getBaseline(): T {\n    return this.baseline;\n  }\n\n  /**\n   * Sets a new baseline value without triggering any dirty state.\n   */\n  public setBaseline(value: T): void {\n    this.baseline = value;\n  }\n\n  /**\n   * Checks whether the given value differs from the baseline.\n   */\n  public isDirty(current: T): boolean {\n    return !this.isEqual(this.baseline, current);\n  }\n\n  /**\n   * Resets the baseline to the provided current value (or clears dirty status).\n   */\n  public reset(current: T): void {\n    this.baseline = current;\n  }\n}\n\n/**\n * Creates a DirtyTracker instance.\n */\nexport function createDirtyTracker<T>(\n  initialBaseline: T,\n  options?: DirtyTrackerOptions<T> | ((a: T, b: T) => boolean),\n): DirtyTracker<T> {\n  return new DirtyTracker(initialBaseline, options);\n}\n","import { defaultImportRegistry, type DocumentImport } from \"./adapters\";\nimport {\n  importFilesIntoEditor,\n  type ImportEditorTarget,\n  type ImportFilesIntoEditorOptions,\n} from \"./editor\";\nimport type { FileLike, ImportOutcome } from \"./registry\";\n\n/**\n * Opens the browser file picker and resolves with the chosen files (an empty\n * array when the dialog is cancelled). `accept` defaults to every extension\n * and MIME type the default registry can import as a document.\n */\nexport function pickImportFiles(options: { accept?: string; multiple?: boolean } = {}): Promise<File[]> {\n  if (typeof document === \"undefined\") return Promise.resolve([]);\n  return new Promise((resolve) => {\n    const input = document.createElement(\"input\");\n    input.type = \"file\";\n    input.accept = options.accept ?? defaultImportRegistry.accept(\"document\");\n    input.multiple = options.multiple ?? true;\n    input.style.display = \"none\";\n    const finish = (files: File[]) => {\n      input.remove();\n      resolve(files);\n    };\n    input.addEventListener(\"change\", () => finish(Array.from(input.files ?? [])), { once: true });\n    input.addEventListener(\"cancel\", () => finish([]), { once: true });\n    document.body.appendChild(input);\n    input.click();\n  });\n}\n\nexport interface FileImportState {\n  isImporting: boolean;\n  /** Last import error (cleared when a new import starts). */\n  error: Error | null;\n  /** Outcomes of the most recent import. */\n  lastOutcomes: ImportOutcome<DocumentImport>[];\n}\n\nexport interface FileImportControllerOptions extends Omit<ImportFilesIntoEditorOptions, \"at\"> {\n  /** Allow choosing several files in the picker (default `true`). */\n  multiple?: boolean;\n}\n\n/**\n * Framework-agnostic state for a file-import button: tracks `isImporting` /\n * `error`, opens the file picker and inserts the imported content into the\n * editor returned by `getTarget`. React's `useFileImport` and Svelte's\n * `createFileImport` wrap it.\n */\nexport class FileImportController {\n  private state: FileImportState = { isImporting: false, error: null, lastOutcomes: [] };\n  private readonly listeners = new Set<(state: FileImportState) => void>();\n  private pending = 0;\n\n  constructor(\n    private readonly getTarget: () => ImportEditorTarget | null | undefined,\n    private options: FileImportControllerOptions = {},\n  ) {}\n\n  setOptions(options: FileImportControllerOptions): void {\n    this.options = options;\n  }\n\n  /** `accept` attribute value for document imports. */\n  get accept(): string {\n    return (this.options.registry ?? defaultImportRegistry).accept(\"document\");\n  }\n\n  getState = (): FileImportState => this.state;\n\n  subscribe = (listener: (state: FileImportState) => void): (() => void) => {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  };\n\n  private setState(patch: Partial<FileImportState>) {\n    this.state = { ...this.state, ...patch };\n    this.listeners.forEach((listener) => listener(this.state));\n  }\n\n  /** Imports files into the editor at `at` (default: the selection). */\n  importFiles = async (\n    files: Iterable<FileLike> | ArrayLike<FileLike>,\n    at?: number,\n  ): Promise<ImportOutcome<DocumentImport>[]> => {\n    const target = this.getTarget();\n    const list = Array.from(files as ArrayLike<FileLike>);\n    if (!target || list.length === 0) return [];\n    this.pending++;\n    this.setState({ isImporting: true, error: null });\n    let error: Error | null = null;\n    try {\n      const outcomes = await importFilesIntoEditor(target, list, {\n        ...this.options,\n        at,\n        onError: (err, file) => {\n          error = err;\n          this.options.onError?.(err, file);\n        },\n      });\n      this.pending--;\n      this.setState({ isImporting: this.pending > 0, error, lastOutcomes: outcomes });\n      return outcomes;\n    } catch (err) {\n      this.pending--;\n      this.setState({ isImporting: this.pending > 0, error: err instanceof Error ? err : new Error(String(err)) });\n      return [];\n    }\n  };\n\n  /** Opens the file picker and imports the chosen files at the selection. */\n  openFilePicker = async (): Promise<ImportOutcome<DocumentImport>[]> => {\n    const files = await pickImportFiles({ accept: this.accept, multiple: this.options.multiple });\n    return this.importFiles(files);\n  };\n}\n\nexport function createFileImportController(\n  getTarget: () => ImportEditorTarget | null | undefined,\n  options?: FileImportControllerOptions,\n): FileImportController {\n  return new FileImportController(getTarget, options);\n}\n"],"mappings":"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","names":[]}

package/dist/registry-iAHbqkYt.d.cts

@@ -0,0 +1,128 @@
+/**
+ * Import adapter registry: maps file types (MIME types and extensions) to
+ * converters that turn a file into editor content. Modelled on the desktop
+ * import pipelines of document apps, where each source format declares the
+ * MIME types and extensions it accepts.
+ *
+ * Built-in adapters cover markdown, HTML, plain text and RTF for the
+ * `document` target. Binary formats (DOCX, PDF, zipped exports) and other
+ * targets (e.g. CSV → `spreadsheet`) plug in with `registerImportAdapter`.
+ */
+/** What an import produces content for. Custom targets are plain strings. */
+type ImportTarget = "document" | "spreadsheet" | (string & {});
+/** A `File`/`Blob`-like object; only the members present are used. */
+interface FileLike {
+    name?: string;
+    type?: string;
+    size?: number;
+    text?(): Promise<string>;
+    arrayBuffer?(): Promise<ArrayBuffer>;
+}
+/** Anything an adapter can import: raw text, binary data, or a file. */
+type ImportInput = string | ArrayBuffer | ArrayBufferView | FileLike;
+/** Helpers passed to adapters so they don't each re-implement decoding. */
+interface ImportContext {
+    fileName?: string;
+    mimeType?: string;
+    target: ImportTarget;
+    /** Reads the input as UTF-8 text (a leading byte-order mark is removed). */
+    readText(): Promise<string>;
+    /** Reads the input as binary data (strings are UTF-8 encoded). */
+    readArrayBuffer(): Promise<ArrayBuffer>;
+}
+interface ImportAdapter<TResult = unknown> {
+    /** Unique id, e.g. `markdown`, `html`, `csv`. */
+    id: string;
+    /** Human-readable name for menus, e.g. "Markdown". */
+    label: string;
+    /** Accepted MIME types; `type/*` wildcards are allowed. */
+    mimeTypes: readonly string[];
+    /** Accepted extensions with a leading dot; multi-part ones (`.md.txt`) are allowed. */
+    extensions: readonly string[];
+    target: ImportTarget;
+    /** Tie-breaker between equally specific matches (default 0, higher wins). */
+    priority?: number;
+    import(input: ImportInput, context: ImportContext): Promise<TResult> | TResult;
+}
+interface FindImportAdapterQuery {
+    mimeType?: string;
+    fileName?: string;
+    /** Only consider adapters for this target. */
+    target?: ImportTarget;
+}
+interface ImportFileOptions {
+    /** Only consider adapters for this target. */
+    target?: ImportTarget;
+    /** Use this adapter instead of matching by type. */
+    adapterId?: string;
+    /** Overrides the input's own `name` (required to match string/binary input by extension). */
+    fileName?: string;
+    /** Overrides the input's own `type`. */
+    mimeType?: string;
+}
+interface ImportOutcome<TResult = unknown> {
+    adapterId: string;
+    target: ImportTarget;
+    fileName?: string;
+    mimeType?: string;
+    result: TResult;
+}
+type ImportErrorCode = "unsupported_type" | "unknown_adapter" | "adapter_failed";
+declare class ImportError extends Error {
+    readonly code: ImportErrorCode;
+    readonly fileName?: string;
+    constructor(code: ImportErrorCode, message: string, details?: {
+        fileName?: string;
+        cause?: unknown;
+    });
+}
+interface RegisterImportAdapterOptions {
+    /** Replace an adapter with the same id instead of throwing. */
+    replace?: boolean;
+}
+/** Creates the {@link ImportContext} helpers for an input. */
+declare function createImportContext(input: ImportInput, details: {
+    fileName?: string;
+    mimeType?: string;
+    target: ImportTarget;
+}): ImportContext;
+/**
+ * A set of import adapters with type matching. Use the default registry via
+ * the module-level helpers (`registerImportAdapter`, `importFile`, …) or
+ * create isolated ones with `createImportAdapterRegistry`.
+ */
+declare class ImportAdapterRegistry {
+    private adapters;
+    /** Registers an adapter and returns a function that unregisters it. */
+    register<TResult>(adapter: ImportAdapter<TResult>, options?: RegisterImportAdapterOptions): () => void;
+    /** Removes an adapter by id or instance. Returns whether it was registered. */
+    unregister(adapterOrId: string | ImportAdapter<any>): boolean;
+    get(id: string): ImportAdapter | undefined;
+    /** Registered adapters in registration order, optionally for one target. */
+    list(target?: ImportTarget): ImportAdapter[];
+    /**
+     * Finds the best adapter for a file. Extensions win over MIME types (browsers
+     * often report `""` or `text/plain` for markdown), the longest matching
+     * extension wins (`.md.txt` beats `.txt`), exact MIME types beat `type/*`
+     * wildcards, then higher `priority`, then the most recently registered.
+     */
+    find(query: FindImportAdapterQuery): ImportAdapter | undefined;
+    /**
+     * Returns a value for `<input type="file" accept="…">` covering every
+     * registered extension and MIME type (optionally for one target).
+     */
+    accept(target?: ImportTarget): string;
+    /** Whether some adapter (optionally for `target`) accepts this file. */
+    canImport(file: {
+        name?: string;
+        type?: string;
+    }, target?: ImportTarget): boolean;
+    /**
+     * Imports a file (or string / binary input) with the matching adapter.
+     * Rejects with an {@link ImportError} when no adapter matches or the
+     * adapter fails.
+     */
+    importFile<TResult = unknown>(input: ImportInput, options?: ImportFileOptions): Promise<ImportOutcome<TResult>>;
+}
+
+export { type FileLike as F, ImportAdapterRegistry as I, type RegisterImportAdapterOptions as R, type ImportOutcome as a, type FindImportAdapterQuery as b, type ImportAdapter as c, type ImportContext as d, ImportError as e, type ImportErrorCode as f, type ImportFileOptions as g, type ImportInput as h, type ImportTarget as i, createImportContext as j };

package/dist/registry-iAHbqkYt.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Import adapter registry: maps file types (MIME types and extensions) to
+ * converters that turn a file into editor content. Modelled on the desktop
+ * import pipelines of document apps, where each source format declares the
+ * MIME types and extensions it accepts.
+ *
+ * Built-in adapters cover markdown, HTML, plain text and RTF for the
+ * `document` target. Binary formats (DOCX, PDF, zipped exports) and other
+ * targets (e.g. CSV → `spreadsheet`) plug in with `registerImportAdapter`.
+ */
+/** What an import produces content for. Custom targets are plain strings. */
+type ImportTarget = "document" | "spreadsheet" | (string & {});
+/** A `File`/`Blob`-like object; only the members present are used. */
+interface FileLike {
+    name?: string;
+    type?: string;
+    size?: number;
+    text?(): Promise<string>;
+    arrayBuffer?(): Promise<ArrayBuffer>;
+}
+/** Anything an adapter can import: raw text, binary data, or a file. */
+type ImportInput = string | ArrayBuffer | ArrayBufferView | FileLike;
+/** Helpers passed to adapters so they don't each re-implement decoding. */
+interface ImportContext {
+    fileName?: string;
+    mimeType?: string;
+    target: ImportTarget;
+    /** Reads the input as UTF-8 text (a leading byte-order mark is removed). */
+    readText(): Promise<string>;
+    /** Reads the input as binary data (strings are UTF-8 encoded). */
+    readArrayBuffer(): Promise<ArrayBuffer>;
+}
+interface ImportAdapter<TResult = unknown> {
+    /** Unique id, e.g. `markdown`, `html`, `csv`. */
+    id: string;
+    /** Human-readable name for menus, e.g. "Markdown". */
+    label: string;
+    /** Accepted MIME types; `type/*` wildcards are allowed. */
+    mimeTypes: readonly string[];
+    /** Accepted extensions with a leading dot; multi-part ones (`.md.txt`) are allowed. */
+    extensions: readonly string[];
+    target: ImportTarget;
+    /** Tie-breaker between equally specific matches (default 0, higher wins). */
+    priority?: number;
+    import(input: ImportInput, context: ImportContext): Promise<TResult> | TResult;
+}
+interface FindImportAdapterQuery {
+    mimeType?: string;
+    fileName?: string;
+    /** Only consider adapters for this target. */
+    target?: ImportTarget;
+}
+interface ImportFileOptions {
+    /** Only consider adapters for this target. */
+    target?: ImportTarget;
+    /** Use this adapter instead of matching by type. */
+    adapterId?: string;
+    /** Overrides the input's own `name` (required to match string/binary input by extension). */
+    fileName?: string;
+    /** Overrides the input's own `type`. */
+    mimeType?: string;
+}
+interface ImportOutcome<TResult = unknown> {
+    adapterId: string;
+    target: ImportTarget;
+    fileName?: string;
+    mimeType?: string;
+    result: TResult;
+}
+type ImportErrorCode = "unsupported_type" | "unknown_adapter" | "adapter_failed";
+declare class ImportError extends Error {
+    readonly code: ImportErrorCode;
+    readonly fileName?: string;
+    constructor(code: ImportErrorCode, message: string, details?: {
+        fileName?: string;
+        cause?: unknown;
+    });
+}
+interface RegisterImportAdapterOptions {
+    /** Replace an adapter with the same id instead of throwing. */
+    replace?: boolean;
+}
+/** Creates the {@link ImportContext} helpers for an input. */
+declare function createImportContext(input: ImportInput, details: {
+    fileName?: string;
+    mimeType?: string;
+    target: ImportTarget;
+}): ImportContext;
+/**
+ * A set of import adapters with type matching. Use the default registry via
+ * the module-level helpers (`registerImportAdapter`, `importFile`, …) or
+ * create isolated ones with `createImportAdapterRegistry`.
+ */
+declare class ImportAdapterRegistry {
+    private adapters;
+    /** Registers an adapter and returns a function that unregisters it. */
+    register<TResult>(adapter: ImportAdapter<TResult>, options?: RegisterImportAdapterOptions): () => void;
+    /** Removes an adapter by id or instance. Returns whether it was registered. */
+    unregister(adapterOrId: string | ImportAdapter<any>): boolean;
+    get(id: string): ImportAdapter | undefined;
+    /** Registered adapters in registration order, optionally for one target. */
+    list(target?: ImportTarget): ImportAdapter[];
+    /**
+     * Finds the best adapter for a file. Extensions win over MIME types (browsers
+     * often report `""` or `text/plain` for markdown), the longest matching
+     * extension wins (`.md.txt` beats `.txt`), exact MIME types beat `type/*`
+     * wildcards, then higher `priority`, then the most recently registered.
+     */
+    find(query: FindImportAdapterQuery): ImportAdapter | undefined;
+    /**
+     * Returns a value for `<input type="file" accept="…">` covering every
+     * registered extension and MIME type (optionally for one target).
+     */
+    accept(target?: ImportTarget): string;
+    /** Whether some adapter (optionally for `target`) accepts this file. */
+    canImport(file: {
+        name?: string;
+        type?: string;
+    }, target?: ImportTarget): boolean;
+    /**
+     * Imports a file (or string / binary input) with the matching adapter.
+     * Rejects with an {@link ImportError} when no adapter matches or the
+     * adapter fails.
+     */
+    importFile<TResult = unknown>(input: ImportInput, options?: ImportFileOptions): Promise<ImportOutcome<TResult>>;
+}
+
+export { type FileLike as F, ImportAdapterRegistry as I, type RegisterImportAdapterOptions as R, type ImportOutcome as a, type FindImportAdapterQuery as b, type ImportAdapter as c, type ImportContext as d, ImportError as e, type ImportErrorCode as f, type ImportFileOptions as g, type ImportInput as h, type ImportTarget as i, createImportContext as j };

package/dist/serializers/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-JACER6TE.cjs');
 
 
 
@@ -9,12 +9,12 @@
 
 
 
+var _chunkLA7PEGU3cjs = require('../chunk-LA7PEGU3.cjs');
 
 
 
 
 
-var _chunkLLUAKTLWcjs = require('../chunk-LLUAKTLW.cjs');
 
 
 
@@ -27,9 +27,32 @@ var _chunkLLUAKTLWcjs = require('../chunk-LLUAKTLW.cjs');
 
 
 
+var _chunkTVRC4KVTcjs = require('../chunk-TVRC4KVT.cjs');
 
 
 
 
-exports.MARKDOWN_MENTION_SPLIT_REGEX = _chunkLLUAKTLWcjs.MARKDOWN_MENTION_SPLIT_REGEX; exports.MENTION_REGEX = _chunkLLUAKTLWcjs.MENTION_REGEX; exports.escapeHtml = _chunkLLUAKTLWcjs.escapeHtml; exports.extractMentions = _chunkLLUAKTLWcjs.extractMentions; exports.extractMentionsFromDoc = _chunkLLUAKTLWcjs.extractMentionsFromDoc; exports.getEditorMarkdown = _chunkLLUAKTLWcjs.getEditorMarkdown; exports.getEditorText = _chunkLLUAKTLWcjs.getEditorText; exports.htmlToPlainText = _chunkLLUAKTLWcjs.htmlToPlainText; exports.markdownToTipTapHtml = _chunkLLUAKTLWcjs.markdownToTipTapHtml; exports.parseMentionSegments = _chunkLLUAKTLWcjs.parseMentionSegments; exports.plainTextToSlice = _chunkLLUAKTLWcjs.plainTextToSlice; exports.plainTextToTipTapHtml = _chunkLLUAKTLWcjs.plainTextToTipTapHtml; exports.preprocessMarkdownFileLinks = _chunkLLUAKTLWcjs.preprocessMarkdownFileLinks; exports.preprocessMarkdownMentions = _chunkLLUAKTLWcjs.preprocessMarkdownMentions; exports.stripMarkdownCode = _chunkLLUAKTLWcjs.stripMarkdownCode;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.MARKDOWN_MENTION_SPLIT_REGEX = _chunkTVRC4KVTcjs.MARKDOWN_MENTION_SPLIT_REGEX; exports.MENTION_REGEX = _chunkTVRC4KVTcjs.MENTION_REGEX; exports.PIXERATE_DOCUMENT_MIME = _chunkLA7PEGU3cjs.PIXERATE_DOCUMENT_MIME; exports.escapeHtml = _chunkTVRC4KVTcjs.escapeHtml; exports.extractMentions = _chunkTVRC4KVTcjs.extractMentions; exports.extractMentionsFromDoc = _chunkTVRC4KVTcjs.extractMentionsFromDoc; exports.getClipboardData = _chunkLA7PEGU3cjs.getClipboardData; exports.getEditorMarkdown = _chunkTVRC4KVTcjs.getEditorMarkdown; exports.getEditorText = _chunkTVRC4KVTcjs.getEditorText; exports.getSchemaSignature = _chunkLA7PEGU3cjs.getSchemaSignature; exports.htmlToPlainText = _chunkTVRC4KVTcjs.htmlToPlainText; exports.markdownToTipTapHtml = _chunkTVRC4KVTcjs.markdownToTipTapHtml; exports.parseMentionSegments = _chunkTVRC4KVTcjs.parseMentionSegments; exports.parseRichClipboardPayload = _chunkLA7PEGU3cjs.parseRichClipboardPayload; exports.plainTextToParagraphHtml = _chunkLA7PEGU3cjs.plainTextToParagraphHtml; exports.plainTextToSlice = _chunkTVRC4KVTcjs.plainTextToSlice; exports.plainTextToTipTapHtml = _chunkTVRC4KVTcjs.plainTextToTipTapHtml; exports.preprocessMarkdownFileLinks = _chunkTVRC4KVTcjs.preprocessMarkdownFileLinks; exports.preprocessMarkdownMentions = _chunkTVRC4KVTcjs.preprocessMarkdownMentions; exports.readRichClipboard = _chunkLA7PEGU3cjs.readRichClipboard; exports.rtfToPlainText = _chunkLA7PEGU3cjs.rtfToPlainText; exports.sanitizeHtml = _chunkTVRC4KVTcjs.sanitizeHtml; exports.sanitizeImportedHtml = _chunkLA7PEGU3cjs.sanitizeImportedHtml; exports.serializeRichClipboardPayload = _chunkLA7PEGU3cjs.serializeRichClipboardPayload; exports.stripMarkdownCode = _chunkTVRC4KVTcjs.stripMarkdownCode;
 //# sourceMappingURL=index.cjs.map

package/dist/serializers/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/editor/editor/packages/core/dist/serializers/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,ggCAAC","file":"/home/runner/work/editor/editor/packages/core/dist/serializers/index.cjs"}
+{"version":3,"sources":["/home/runner/work/editor/editor/packages/core/dist/serializers/index.cjs"],"names":[],"mappings":"AAAA,0GAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,gsDAAC","file":"/home/runner/work/editor/editor/packages/core/dist/serializers/index.cjs"}

package/dist/serializers/index.d.cts

@@ -1,9 +1,19 @@
 import { Schema, Slice } from '@tiptap/pm/model';
-import { a as MentionEntity } from '../mention-Dcevh3ff.cjs';
+import { r as TrackedChangesView, h as MentionEntity } from '../track-changes-G8JcWB8b.cjs';
 import '@tiptap/core';
 import '@tiptap/extension-mention';
 import '@tiptap/suggestion';
+import '@tiptap/pm/state';
 
+interface PlainTextOptions {
+    /**
+     * How tracked changes (`TrackChanges` extension) appear in the text.
+     * Defaults to `"accepted"`: deleted text is dropped and inserted text kept,
+     * so suggested deletions never leak into exported text. `"original"` drops
+     * insertions and keeps deletions; `"all"` keeps both.
+     */
+    trackedChanges?: TrackedChangesView;
+}
 /**
  * Escapes characters that have syntactic meaning in HTML text.
  */
@@ -23,12 +33,13 @@ declare function plainTextToSlice(text: string, schema: Schema): Slice;
 /**
  * Extracts plain text from an HTML string or TipTap HTML, preserving newlines between block tags.
  */
-declare function htmlToPlainText(html: string): string;
+declare function htmlToPlainText(html: string, options?: PlainTextOptions): string;
 /**
  * Extracts plain text from a TipTap editor instance, preserving newline separators
- * between block nodes and converting mention nodes to @label.
+ * between block nodes and converting mention nodes to @label. Tracked changes
+ * are rendered as accepted unless `options.trackedChanges` says otherwise.
  */
-declare function getEditorText(editor: any): string;
+declare function getEditorText(editor: any, options?: PlainTextOptions): string;
 interface ExtractedMention {
     id: string;
     label: string;
@@ -101,6 +112,21 @@ declare function parseMentionSegments(content: string): MentionSegment[];
  */
 declare function preprocessMarkdownMentions(content: string, optionsOrMentionables?: MentionEntity[] | PreprocessMarkdownMentionsOptions): string;
 
+interface SanitizeHtmlOptions {
+    /**
+     * What to do with tags outside the allowlist: `escape` (default) renders
+     * them as literal text, `strip` removes the tag but keeps its text content.
+     */
+    disallowedTags?: "escape" | "strip";
+}
+/**
+ * Sanitizes raw HTML with the same allowlist the markdown renderer applies to
+ * embedded HTML: event handlers, `style` and unsafe URL schemes are dropped,
+ * and disallowed tags are escaped (or removed with `disallowedTags: "strip"`).
+ * It is string-based, so it works without a DOM and never runs handlers.
+ */
+declare function sanitizeHtml(html: string, options?: SanitizeHtmlOptions): string;
+
 /**
  * Preprocesses file-protocol and editor-protocol links in markdown content:
  * converts [label](file://...), vscode://, and cursor:// links into anchor tags
@@ -141,7 +167,94 @@ declare function markdownToTipTapHtml(markdown: string, options?: MarkdownToHtml
  * Extracts clean markdown from a TipTap editor instance.
  * If the editor has the Markdown extension configured, it uses editor.storage.markdown.getMarkdown().
  * Otherwise, it falls back to getEditorText(editor).
+ * Tracked changes are exported as accepted unless `options.trackedChanges`
+ * says otherwise (`"all"` renders deletions as `~~strikethrough~~`).
+ */
+declare function getEditorMarkdown(editor: any, options?: PlainTextOptions): string;
+
+/**
+ * Sanitizes a full HTML document or fragment for insertion into the editor,
+ * e.g. an imported `.html` file or HTML from another application.
+ *
+ * - Keeps only the `<body>` content when the input is a full document.
+ * - Removes comments, doctype/XML declarations, CDATA, scripts, styles and
+ *   other non-text elements together with their content.
+ * - Applies the same tag/attribute/URL allowlist as embedded HTML in markdown
+ *   (see `sanitizeHtml`), but strips disallowed tags instead of escaping them,
+ *   so wrappers such as `<section>` or `<font>` keep their text.
+ *
+ * It is string-based (no live DOM), so handlers such as `<img onerror>` never run.
+ */
+declare function sanitizeImportedHtml(html: string): string;
+/**
+ * Converts untrusted plain text to TipTap paragraph HTML, always escaping it.
+ *
+ * Unlike `plainTextToTipTapHtml`, text that already looks like `<p>…</p>` is
+ * not passed through as HTML, which matters for imported files.
+ */
+declare function plainTextToParagraphHtml(text: string): string;
+
+/**
+ * Best-effort plain-text extraction from an RTF document.
+ *
+ * Handles paragraphs/line breaks/tabs, escaped braces and backslashes,
+ * `\'hh` hex escapes (decoded as Windows-1252), `\uN` Unicode escapes with
+ * their `\ucN` fallback characters, common typographic control words, and
+ * skips metadata destinations (font/colour tables, `\info`, pictures, field
+ * instructions, `\*` destinations). Formatting (bold, lists, tables) is not
+ * preserved. Input that does not start with `{\rtf` is returned unchanged.
+ */
+declare function rtfToPlainText(rtf: string): string;
+
+/**
+ * Custom clipboard MIME type for content copied from a @pixerate/editor
+ * rich-text editor. It carries the ProseMirror slice as JSON so pasting back
+ * into a compatible editor is lossless (no HTML round trip).
+ */
+declare const PIXERATE_DOCUMENT_MIME = "application/x.pixerate.document+json";
+/** Payload written under {@link PIXERATE_DOCUMENT_MIME}. */
+interface RichClipboardPayload {
+    version: 1;
+    /** {@link getSchemaSignature} of the source editor's schema. */
+    schema: string;
+    /** `Slice.toJSON()` of the copied selection. */
+    slice: {
+        content?: unknown[];
+        openStart?: number;
+        openEnd?: number;
+    } | null;
+}
+/**
+ * Returns a stable signature for a ProseMirror schema: node names, content
+ * expressions, groups, attribute names and mark names. Two editors with the
+ * same extensions produce the same signature, so a slice copied from one can
+ * be deserialized in the other without losing or rejecting nodes.
+ */
+declare function getSchemaSignature(schema: Schema): string;
+/** Serializes a slice into the {@link PIXERATE_DOCUMENT_MIME} payload string. */
+declare function serializeRichClipboardPayload(slice: Slice, schema: Schema): string;
+/**
+ * Parses a {@link PIXERATE_DOCUMENT_MIME} payload into a slice for `schema`.
+ * Returns `null` (so callers fall back to HTML / plain text) when the payload
+ * is malformed, from another payload version, or from an editor whose schema
+ * signature differs.
+ */
+declare function parseRichClipboardPayload(data: string | null | undefined, schema: Schema): Slice | null;
+/** Minimal clipboard data surface (`DataTransfer`). */
+interface ClipboardDataLike {
+    getData(format: string): string;
+    setData(format: string, data: string): void;
+    clearData?(format?: string): void;
+}
+/**
+ * Returns the `clipboardData` of a native `ClipboardEvent` or of a React
+ * synthetic clipboard event (which wraps the native event in `nativeEvent`).
+ */
+declare function getClipboardData(event: unknown): ClipboardDataLike | null;
+/**
+ * Reads a slice from a paste event's {@link PIXERATE_DOCUMENT_MIME} data.
+ * Returns `null` when the data is missing or its schema does not match.
  */
-declare function getEditorMarkdown(editor: any): string;
+declare function readRichClipboard(event: unknown, schema: Schema, mimeType?: string): Slice | null;
 
-export { type ExtractedMention, MARKDOWN_MENTION_SPLIT_REGEX, MENTION_REGEX, type MarkdownToHtmlOptions, type MentionSegment, type PreprocessMarkdownMentionsOptions, escapeHtml, extractMentions, extractMentionsFromDoc, getEditorMarkdown, getEditorText, htmlToPlainText, markdownToTipTapHtml, parseMentionSegments, plainTextToSlice, plainTextToTipTapHtml, preprocessMarkdownFileLinks, preprocessMarkdownMentions, stripMarkdownCode };
+export { type ClipboardDataLike, type ExtractedMention, MARKDOWN_MENTION_SPLIT_REGEX, MENTION_REGEX, type MarkdownToHtmlOptions, type MentionSegment, PIXERATE_DOCUMENT_MIME, type PlainTextOptions, type PreprocessMarkdownMentionsOptions, type RichClipboardPayload, type SanitizeHtmlOptions, escapeHtml, extractMentions, extractMentionsFromDoc, getClipboardData, getEditorMarkdown, getEditorText, getSchemaSignature, htmlToPlainText, markdownToTipTapHtml, parseMentionSegments, parseRichClipboardPayload, plainTextToParagraphHtml, plainTextToSlice, plainTextToTipTapHtml, preprocessMarkdownFileLinks, preprocessMarkdownMentions, readRichClipboard, rtfToPlainText, sanitizeHtml, sanitizeImportedHtml, serializeRichClipboardPayload, stripMarkdownCode };