@pixerate/editor 0.8.1 → 0.9.0

package/dist/index.d.cts

@@ -1,8 +1,9 @@
 import { T as Token } from './tokens-7kRTEtPb.cjs';
 export { C as ColorGradient, I as INSTRUCTION_REGEX, a as TEMPLATE_REGEX, b as Template, c as TemplateVersion, d as TokenType, V as VARIABLE_REGEX, i as instructionRegex, t as templateRegex, v as variableRegex } from './tokens-7kRTEtPb.cjs';
 export { ResolveTemplatesOptions, SourceMapSegment, extractInstructionNames, extractTemplateNames, extractVariableNames, getLatestVersion, mapRawOffsetToResolved, mapResolvedOffsetToRaw, resolveTemplates, resolveTemplatesWithMapping, resolveVariables, tokenizePrompt } from './grammar/index.cjs';
-export { ColorHighlighter, FontSize, GradientText, GradientTextOptions, Image, ImageOptions, LoadingNode, Markdown, Mention, MentionEntity, MentionOptions, RichTextPresetOptions, SlashCommandMatchData, SlashCommands, SlashCommandsOptions, SmilieReplacer, TemplateSuggestions, TemplateSuggestionsOptions, createMentionExtension, createRichTextPreset, findHexColors, handleImageInsertion, imagePastePluginKey, insertImageNode, removeImageNode, updateImageSrc } from './extensions/index.cjs';
-export { ExtractedMention, escapeHtml, extractMentionsFromDoc, getEditorMarkdown, getEditorText, htmlToPlainText, markdownToTipTapHtml, plainTextToTipTapHtml } from './serializers/index.cjs';
+export { ColorHighlighter, FontSize, GradientText, GradientTextOptions, Image, ImageOptions, LoadingNode, Markdown, RichTextPresetOptions, SlashCommandMatchData, SlashCommands, SlashCommandsOptions, SmilieReplacer, TemplateSuggestions, TemplateSuggestionsOptions, createRichTextPreset, findHexColors, handleImageInsertion, imagePastePluginKey, insertImageNode, removeImageNode, updateImageSrc } from './extensions/index.cjs';
+export { M as Mention, a as MentionEntity, b as MentionOptions, c as createMentionExtension } from './mention-Dcevh3ff.cjs';
+export { ExtractedMention, MARKDOWN_MENTION_SPLIT_REGEX, MENTION_REGEX, MarkdownToHtmlOptions, MentionSegment, PreprocessMarkdownMentionsOptions, escapeHtml, extractMentions, extractMentionsFromDoc, getEditorMarkdown, getEditorText, htmlToPlainText, markdownToTipTapHtml, parseMentionSegments, plainTextToTipTapHtml, preprocessMarkdownFileLinks, preprocessMarkdownMentions, stripMarkdownCode } from './serializers/index.cjs';
 import { Editor, EditorOptions, Content, Extensions } from '@tiptap/core';
 export { Content, Editor, EditorOptions, Extensions } from '@tiptap/core';
 export { ASTNode, BinaryOpNode, CellCoordinate, CellData, CellDep, CellFormat, CellRange, CellRefNode, ColumnBinding, ColumnType, DataSourceBinder, DependencyGraph, EvaluationContext, FormulaEvaluator, FormulaParser, FormulaToken, FormulaTokenType, FunctionCallNode, LiteralNode, PropertyRefNode, RangeNode, RowType, SpreadsheetColumn, SpreadsheetController, SpreadsheetControllerOptions, SpreadsheetDataSource, SpreadsheetDataSourceField, SpreadsheetDocument, SpreadsheetRow, UnaryOpNode, colNameToIndex, extractCellDependencies, indexToColName, parseCellReference, parseFormula, parseRange, tokenizeFormula } from './spreadsheet/index.cjs';
@@ -10,10 +11,10 @@ export { Command, HistoryManager, HistoryManagerOptions, HistoryState, MergedExe
 export { MarkdownOptions } from 'tiptap-markdown';
 import '@tiptap/pm/view';
 import '@tiptap/pm/model';
-import '@tiptap/extension-mention';
-import '@tiptap/suggestion';
 import '@tiptap/extension-image';
 import '@tiptap/pm/state';
+import '@tiptap/extension-mention';
+import '@tiptap/suggestion';
 
 interface EditorControllerOptions extends Partial<Omit<EditorOptions, "element" | "content">> {
     element?: Element | HTMLElement | null;

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import { T as Token } from './tokens-7kRTEtPb.js';
 export { C as ColorGradient, I as INSTRUCTION_REGEX, a as TEMPLATE_REGEX, b as Template, c as TemplateVersion, d as TokenType, V as VARIABLE_REGEX, i as instructionRegex, t as templateRegex, v as variableRegex } from './tokens-7kRTEtPb.js';
 export { ResolveTemplatesOptions, SourceMapSegment, extractInstructionNames, extractTemplateNames, extractVariableNames, getLatestVersion, mapRawOffsetToResolved, mapResolvedOffsetToRaw, resolveTemplates, resolveTemplatesWithMapping, resolveVariables, tokenizePrompt } from './grammar/index.js';
-export { ColorHighlighter, FontSize, GradientText, GradientTextOptions, Image, ImageOptions, LoadingNode, Markdown, Mention, MentionEntity, MentionOptions, RichTextPresetOptions, SlashCommandMatchData, SlashCommands, SlashCommandsOptions, SmilieReplacer, TemplateSuggestions, TemplateSuggestionsOptions, createMentionExtension, createRichTextPreset, findHexColors, handleImageInsertion, imagePastePluginKey, insertImageNode, removeImageNode, updateImageSrc } from './extensions/index.js';
-export { ExtractedMention, escapeHtml, extractMentionsFromDoc, getEditorMarkdown, getEditorText, htmlToPlainText, markdownToTipTapHtml, plainTextToTipTapHtml } from './serializers/index.js';
+export { ColorHighlighter, FontSize, GradientText, GradientTextOptions, Image, ImageOptions, LoadingNode, Markdown, RichTextPresetOptions, SlashCommandMatchData, SlashCommands, SlashCommandsOptions, SmilieReplacer, TemplateSuggestions, TemplateSuggestionsOptions, createRichTextPreset, findHexColors, handleImageInsertion, imagePastePluginKey, insertImageNode, removeImageNode, updateImageSrc } from './extensions/index.js';
+export { M as Mention, a as MentionEntity, b as MentionOptions, c as createMentionExtension } from './mention-Dcevh3ff.js';
+export { ExtractedMention, MARKDOWN_MENTION_SPLIT_REGEX, MENTION_REGEX, MarkdownToHtmlOptions, MentionSegment, PreprocessMarkdownMentionsOptions, escapeHtml, extractMentions, extractMentionsFromDoc, getEditorMarkdown, getEditorText, htmlToPlainText, markdownToTipTapHtml, parseMentionSegments, plainTextToTipTapHtml, preprocessMarkdownFileLinks, preprocessMarkdownMentions, stripMarkdownCode } from './serializers/index.js';
 import { Editor, EditorOptions, Content, Extensions } from '@tiptap/core';
 export { Content, Editor, EditorOptions, Extensions } from '@tiptap/core';
 export { ASTNode, BinaryOpNode, CellCoordinate, CellData, CellDep, CellFormat, CellRange, CellRefNode, ColumnBinding, ColumnType, DataSourceBinder, DependencyGraph, EvaluationContext, FormulaEvaluator, FormulaParser, FormulaToken, FormulaTokenType, FunctionCallNode, LiteralNode, PropertyRefNode, RangeNode, RowType, SpreadsheetColumn, SpreadsheetController, SpreadsheetControllerOptions, SpreadsheetDataSource, SpreadsheetDataSourceField, SpreadsheetDocument, SpreadsheetRow, UnaryOpNode, colNameToIndex, extractCellDependencies, indexToColName, parseCellReference, parseFormula, parseRange, tokenizeFormula } from './spreadsheet/index.js';
@@ -10,10 +11,10 @@ export { Command, HistoryManager, HistoryManagerOptions, HistoryState, MergedExe
 export { MarkdownOptions } from 'tiptap-markdown';
 import '@tiptap/pm/view';
 import '@tiptap/pm/model';
-import '@tiptap/extension-mention';
-import '@tiptap/suggestion';
 import '@tiptap/extension-image';
 import '@tiptap/pm/state';
+import '@tiptap/extension-mention';
+import '@tiptap/suggestion';
 
 interface EditorControllerOptions extends Partial<Omit<EditorOptions, "element" | "content">> {
     element?: Element | HTMLElement | null;

package/dist/index.js

@@ -2200,6 +2200,150 @@ function createRichTextPreset(options = {}) {
   return extensions2;
 }
 
+// src/serializers/mentions.ts
+var MENTION_REGEX = /(?:^|[\s>(*_"';\\/[\]{}~`:]|"|>|<|&)@(?:"([^"]+)"|"([^&]+)"|([a-zA-Z0-9_-]+(?:\.[a-zA-Z0-9_-]+)*))/g;
+var MARKDOWN_MENTION_SPLIT_REGEX = /(```[\s\S]*?```|~~~[\s\S]*?~~~|<pre[\s\S]*?<\/pre>|<code[\s\S]*?<\/code>|`[^`\n]+`|<span\b[^>]*\b(?:data-type=["']mention["']|class=["'][^"']*pixerate-mention-node[^"']*["']|data-mention=["'][^"']*["'])[^>]*>[\s\S]*?<\/span>|<[^>]+>|\]\([^)]+\)|(?:https?|file|vscode|cursor|mailto):\/\/[^\s<)]+)/gi;
+function stripMarkdownCode(content) {
+  if (!content || typeof content !== "string") return "";
+  return content.replace(/```[\s\S]*?```/g, "").replace(/~~~[\s\S]*?~~~/g, "").replace(/<pre[\s\S]*?<\/pre>/gi, "").replace(/<code[\s\S]*?<\/code>/gi, "").replace(/`[^`\n]*`/g, "");
+}
+function extractMentions(content) {
+  if (!content || typeof content !== "string") return [];
+  const normalizedMentionNodes = content.replace(
+    /<span\b[^>]*\b(?:data-type=["']mention["']|class=["'][^"']*pixerate-mention-node[^"']*["'])[^>]*>([\s\S]*?)<\/span>/gi,
+    (match2, inner) => {
+      const labelMatch = match2.match(/\bdata-label=["']([^"']+)["']/i);
+      if (labelMatch) return ` @${labelMatch[1]} `;
+      const idMatch = match2.match(/\bdata-id=["']([^"']+)["']/i);
+      if (idMatch) return ` @${idMatch[1]} `;
+      return ` ${inner} `;
+    }
+  );
+  const cleanContent = stripMarkdownCode(normalizedMentionNodes);
+  const withoutUrls = cleanContent.replace(/(?:https?|ftp|file|vscode|cursor|mailto):\/\/[^\s<>()]+/gi, "").replace(/\]\([^)]*\)/g, "]");
+  const textOnly = withoutUrls.replace(/<[^>]+>/g, " ");
+  const mentions = [];
+  const seen = /* @__PURE__ */ new Set();
+  const regex = new RegExp(MENTION_REGEX.source, "g");
+  let match;
+  while ((match = regex.exec(textOnly)) !== null) {
+    const handle = (match[1] ?? match[2] ?? match[3] ?? "").trim();
+    if (handle && !seen.has(handle)) {
+      seen.add(handle);
+      mentions.push(handle);
+    }
+  }
+  return mentions;
+}
+function parseMentionSegments(content) {
+  if (!content) return [];
+  const segments = [];
+  const regex = new RegExp(MENTION_REGEX.source, "g");
+  let lastIndex = 0;
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    const fullMatch = match[0];
+    const atIndex = fullMatch.indexOf("@");
+    const prefix = atIndex > 0 ? fullMatch.slice(0, atIndex) : "";
+    const mentionToken = fullMatch.slice(atIndex);
+    const handle = match[1] ?? match[2] ?? match[3];
+    const matchStart = match.index + prefix.length;
+    if (matchStart > lastIndex) {
+      segments.push({
+        type: "text",
+        value: content.slice(lastIndex, matchStart)
+      });
+    }
+    segments.push({
+      type: "mention",
+      value: mentionToken,
+      handle
+    });
+    lastIndex = matchStart + mentionToken.length;
+  }
+  if (lastIndex < content.length) {
+    segments.push({
+      type: "text",
+      value: content.slice(lastIndex)
+    });
+  }
+  return segments;
+}
+function preprocessMarkdownMentions(content, optionsOrMentionables = []) {
+  if (!content || typeof content !== "string") return "";
+  const options = Array.isArray(optionsOrMentionables) ? { mentionables: optionsOrMentionables } : optionsOrMentionables;
+  const allMentionables = options.mentionables || [];
+  const defaultType = options.defaultType || "user";
+  const resolveMention = options.resolveMention;
+  const parts = content.split(MARKDOWN_MENTION_SPLIT_REGEX);
+  return parts.map((part) => {
+    if (!part) return "";
+    if (part.startsWith("```") || part.startsWith("~~~") || part.startsWith("`") || part.startsWith("](") || /^(?:https?|file|vscode|cursor|mailto):\/\//i.test(part) || /^<pre[\s>]/i.test(part) || /^<code[\s>]/i.test(part) || /^<[^>]+>$/i.test(part) || /^<span\b[^>]*\b(?:data-type=["']mention["']|class=["'][^"']*pixerate-mention-node[^"']*["']|data-mention=["'][^"']*["'])/i.test(
+      part
+    )) {
+      return part;
+    }
+    const regex = new RegExp(MENTION_REGEX.source, "g");
+    return part.replace(regex, (match, quotedHandle, escapedQuotedHandle, standardHandle) => {
+      const atIndex = match.indexOf("@");
+      const prefix = atIndex > 0 ? match.slice(0, atIndex) : "";
+      const rawHandle = (quotedHandle || escapedQuotedHandle || standardHandle || "").trim();
+      if (!rawHandle) return match;
+      const lowerHandle = rawHandle.toLowerCase();
+      const entity = allMentionables.find((e) => {
+        if (e.label?.toLowerCase() === lowerHandle) return true;
+        if (e.handle?.toLowerCase() === lowerHandle) return true;
+        if (e.name?.toLowerCase() === lowerHandle) return true;
+        if (e.id?.toLowerCase() === lowerHandle) return true;
+        if (e.type === "agent" && `agent${(e.handle || e.label || "").toLowerCase()}` === lowerHandle) return true;
+        if (e.aliases?.some(
+          (a) => a.toLowerCase() === lowerHandle || e.type === "agent" && `agent${a.toLowerCase()}` === lowerHandle
+        )) {
+          return true;
+        }
+        return false;
+      });
+      let id = entity?.id;
+      let label = entity?.label || entity?.handle || rawHandle;
+      let type = entity?.type;
+      let avatarUrl = entity?.avatarUrl;
+      let color = entity?.color || entity?.hexColor;
+      if (!entity) {
+        const customResolved = resolveMention?.(rawHandle);
+        if (customResolved) {
+          id = customResolved.id ?? id;
+          label = customResolved.label ?? customResolved.handle ?? label;
+          type = customResolved.type ?? type;
+          avatarUrl = customResolved.avatarUrl ?? avatarUrl;
+          color = customResolved.color ?? customResolved.hexColor ?? color;
+        } else {
+          const stripped = lowerHandle.replace(/^agent[\s\-_]*/i, "");
+          if (["supervisor", "coordinator", "planner", "validator", "executor"].includes(stripped)) {
+            type = "agent";
+            id = stripped;
+            label = stripped;
+          } else if (lowerHandle === "agents") {
+            type = "team";
+            id = "agents";
+            label = "agents";
+          } else {
+            type = defaultType;
+            id = rawHandle;
+            label = rawHandle;
+          }
+        }
+      }
+      const avatarAttr = avatarUrl ? ` data-avatar-url="${escapeHtml(avatarUrl)}"` : "";
+      const colorAttr = color ? ` data-color="${escapeHtml(color)}"` : "";
+      return `${prefix}<span class="pixerate-mention-node" data-type="mention" data-id="${escapeHtml(
+        id || label
+      )}" data-label="${escapeHtml(label)}" data-mention-suggestion-char="@" data-type-name="${escapeHtml(
+        type || defaultType
+      )}"${avatarAttr}${colorAttr}>@${escapeHtml(label)}</span>`;
+    });
+  }).join("");
+}
+
 // src/serializers/plain-text.ts
 function escapeHtml(text) {
   if (!text) return "";
@@ -2324,6 +2468,16 @@ function extractMentionsFromDoc(docOrEditor) {
         });
       }
     }
+    if (mentions.length === 0) {
+      const rawHandles = extractMentions(docOrEditor);
+      for (const handle of rawHandles) {
+        mentions.push({
+          id: handle,
+          label: handle,
+          type: "user"
+        });
+      }
+    }
   }
   return mentions;
 }
@@ -2343,9 +2497,31 @@ md2.validateLink = (url) => {
   }
   return defaultValidateLink.call(md2, url);
 };
-function markdownToTipTapHtml(markdown) {
+function preprocessMarkdownFileLinks(content) {
+  if (!content) return "";
+  return content.replace(
+    /\[([^\]]+)\]\(((?:file|vscode|cursor):\/\/[^)]+)\)/g,
+    (_match, rawLabel, href) => {
+      const trimmed = rawLabel.trim();
+      const codeMatch = trimmed.match(/^`([^`]+)`$/);
+      const labelContent = codeMatch ? `<code>${codeMatch[1]}</code>` : trimmed;
+      return `<a href="${href}" data-file-link="true" title="Click to copy file path">${labelContent}</a>`;
+    }
+  );
+}
+function markdownToTipTapHtml(markdown, options) {
   if (!markdown) return "<p></p>";
-  return md2.render(markdown);
+  let content = markdown;
+  if (options?.preprocessFileLinks) {
+    content = preprocessMarkdownFileLinks(content);
+  }
+  if (options?.preprocessMentions || options?.mentionables || options?.preprocessOptions) {
+    const mentionOpts = options.preprocessOptions || {
+      mentionables: options.mentionables
+    };
+    content = preprocessMarkdownMentions(content, mentionOpts);
+  }
+  return md2.render(content);
 }
 function getEditorMarkdown(editor) {
   if (!editor) return "";
@@ -4084,6 +4260,8 @@ export {
   INSTRUCTION_REGEX,
   Image2 as Image,
   LoadingNode,
+  MARKDOWN_MENTION_SPLIT_REGEX,
+  MENTION_REGEX,
   Markdown2 as Markdown,
   Mention,
   SlashCommands,
@@ -4102,6 +4280,7 @@ export {
   escapeHtml,
   extractCellDependencies,
   extractInstructionNames,
+  extractMentions,
   extractMentionsFromDoc,
   extractTemplateNames,
   extractVariableNames,
@@ -4120,12 +4299,16 @@ export {
   markdownToTipTapHtml,
   parseCellReference,
   parseFormula,
+  parseMentionSegments,
   parseRange,
   plainTextToTipTapHtml,
+  preprocessMarkdownFileLinks,
+  preprocessMarkdownMentions,
   removeImageNode,
   resolveTemplates,
   resolveTemplatesWithMapping,
   resolveVariables,
+  stripMarkdownCode,
   templateRegex,
   tokenizeFormula,
   tokenizePrompt,