@pixerate/editor 0.8.1 → 0.10.0

package/dist/serializers/index.js

@@ -1,3 +1,147 @@
+// 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 "";
@@ -122,6 +266,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;
 }
@@ -141,9 +295,31 @@ md.validateLink = (url) => {
   }
   return defaultValidateLink.call(md, 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 md.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 md.render(content);
 }
 function getEditorMarkdown(editor) {
   if (!editor) return "";
@@ -153,12 +329,19 @@ function getEditorMarkdown(editor) {
   return getEditorText(editor);
 }
 export {
+  MARKDOWN_MENTION_SPLIT_REGEX,
+  MENTION_REGEX,
   escapeHtml,
+  extractMentions,
   extractMentionsFromDoc,
   getEditorMarkdown,
   getEditorText,
   htmlToPlainText,
   markdownToTipTapHtml,
-  plainTextToTipTapHtml
+  parseMentionSegments,
+  plainTextToTipTapHtml,
+  preprocessMarkdownFileLinks,
+  preprocessMarkdownMentions,
+  stripMarkdownCode
 };
 //# sourceMappingURL=index.js.map

package/dist/serializers/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/serializers/plain-text.ts","../../src/serializers/markdown.ts"],"sourcesContent":["/**\n * Escapes characters that have syntactic meaning in HTML text.\n */\nexport function escapeHtml(text: string): string {\n  if (!text) return \"\";\n  return text\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/'/g, \"&#039;\");\n}\n\n/**\n * Converts a plain-text string with newlines into HTML paragraphs suitable\n * for TipTap initial content or setContent, preserving line breaks.\n */\nexport function plainTextToTipTapHtml(text: string): string {\n  if (!text) return \"<p></p>\";\n  if (/<p[\\s>]/i.test(text)) {\n    return text;\n  }\n  return text\n    .replace(/\\r\\n/g, \"\\n\")\n    .replace(/\\r/g, \"\\n\")\n    .split(\"\\n\")\n    .map((line) => `<p>${escapeHtml(line)}</p>`)\n    .join(\"\");\n}\n\n/**\n * Extracts plain text from an HTML string or TipTap HTML, preserving newlines between block tags.\n */\nexport function htmlToPlainText(html: string): string {\n  if (!html) return \"\";\n\n  // Normalize mentions so data-label is preserved as @label even if textContent is empty\n  const mentionNormalized = html\n    .replace(\n      /<span[^>]*data-type=[\"']mention[\"'][^>]*data-label=[\"']([^\"']+)[\"'][^>]*>.*?<\\/span>/gi,\n      \"@$1\",\n    )\n    .replace(\n      /<span[^>]*data-type=[\"']mention[\"'][^>]*data-id=[\"']([^\"']+)[\"'][^>]*>.*?<\\/span>/gi,\n      \"@$1\",\n    );\n\n  if (typeof document !== \"undefined\") {\n    const tempDiv = document.createElement(\"div\");\n    tempDiv.innerHTML = mentionNormalized;\n    tempDiv\n      .querySelectorAll(\"br.ProseMirror-trailingBreak\")\n      .forEach((br) => br.remove());\n    tempDiv.querySelectorAll(\"br\").forEach((br) => br.replaceWith(\"\\n\"));\n    const paragraphs = tempDiv.querySelectorAll(\"p, div, li, h1, h2, h3, h4, h5, h6\");\n    if (paragraphs.length > 0) {\n      const textParts: string[] = [];\n      paragraphs.forEach((p) => {\n        textParts.push(p.textContent || \"\");\n      });\n      return textParts.join(\"\\n\");\n    }\n    return tempDiv.textContent || \"\";\n  }\n\n  // Node.js fallback regex\n  return mentionNormalized\n    .replace(/<br\\s*\\/?>/gi, \"\\n\")\n    .replace(/<\\/p>/gi, \"\\n\")\n    .replace(/<\\/div>/gi, \"\\n\")\n    .replace(/<\\/li>/gi, \"\\n\")\n    .replace(/<[^>]+>/g, \"\")\n    .replace(/&amp;/g, \"&\")\n    .replace(/&lt;/g, \"<\")\n    .replace(/&gt;/g, \">\")\n    .replace(/&quot;/g, '\"')\n    .replace(/&#039;/g, \"'\")\n    .trim();\n}\n\n/**\n * Extracts plain text from a TipTap editor instance, preserving newline separators\n * between block nodes and converting mention nodes to @label.\n */\nexport function getEditorText(editor: any): string {\n  if (!editor) return \"\";\n  const html = typeof editor.getHTML === \"function\" ? editor.getHTML() : \"\";\n  if (html) {\n    return htmlToPlainText(html);\n  }\n  if (typeof editor.getText === \"function\") {\n    try {\n      return editor.getText({ blockSeparator: \"\\n\" });\n    } catch {\n      return editor.getText();\n    }\n  }\n  return \"\";\n}\n\nexport interface ExtractedMention {\n  id: string;\n  label: string;\n  type?: string;\n  avatarUrl?: string;\n  color?: string;\n  [key: string]: any;\n}\n\n/**\n * Traverses an editor instance, ProseMirror document, JSONContent, or HTML string\n * and extracts all mention attributes without needing regex.\n */\nexport function extractMentionsFromDoc(docOrEditor: any): ExtractedMention[] {\n  if (!docOrEditor) return [];\n  const mentions: ExtractedMention[] = [];\n\n  // TipTap editor or ProseMirror Node with .descendants()\n  const doc =\n    docOrEditor?.state?.doc ||\n    (typeof docOrEditor?.descendants === \"function\" ? docOrEditor : null);\n\n  if (doc && typeof doc.descendants === \"function\") {\n    doc.descendants((node: any) => {\n      if (node.type?.name === \"mention\" && node.attrs) {\n        mentions.push({\n          id: node.attrs.id || \"\",\n          label: node.attrs.label || \"\",\n          type: node.attrs.type,\n          avatarUrl: node.attrs.avatarUrl,\n          color: node.attrs.color,\n          ...node.attrs,\n        });\n      }\n    });\n    return mentions;\n  }\n\n  // JSONContent tree\n  if (typeof docOrEditor === \"object\" && docOrEditor.content) {\n    const walk = (nodes: any[]) => {\n      for (const node of nodes) {\n        if (node.type === \"mention\" && node.attrs) {\n          mentions.push({\n            id: node.attrs.id || \"\",\n            label: node.attrs.label || \"\",\n            type: node.attrs.type,\n            avatarUrl: node.attrs.avatarUrl,\n            color: node.attrs.color,\n            ...node.attrs,\n          });\n        }\n        if (Array.isArray(node.content)) {\n          walk(node.content);\n        }\n      }\n    };\n    walk(docOrEditor.content);\n    return mentions;\n  }\n\n  // HTML String\n  if (typeof docOrEditor === \"string\") {\n    if (typeof document !== \"undefined\") {\n      const div = document.createElement(\"div\");\n      div.innerHTML = docOrEditor;\n      div.querySelectorAll('span[data-type=\"mention\"]').forEach((el) => {\n        mentions.push({\n          id: el.getAttribute(\"data-id\") || \"\",\n          label: el.getAttribute(\"data-label\") || \"\",\n          type: el.getAttribute(\"data-type-name\") || undefined,\n          avatarUrl: el.getAttribute(\"data-avatar-url\") || undefined,\n          color: el.getAttribute(\"data-color\") || undefined,\n        });\n      });\n    } else {\n      const spanRegex = /<span([^>]*data-type=[\"']mention[\"'][^>]*)>/gi;\n      let match;\n      while ((match = spanRegex.exec(docOrEditor)) !== null) {\n        const attrStr = match[1];\n        const getAttr = (name: string) => {\n          const m = new RegExp(`${name}=[\"']([^\"']*)[\"']`, \"i\").exec(attrStr);\n          return m ? m[1] : undefined;\n        };\n        mentions.push({\n          id: getAttr(\"data-id\") || \"\",\n          label: getAttr(\"data-label\") || \"\",\n          type: getAttr(\"data-type-name\") || getAttr(\"data-entity-type\"),\n          avatarUrl: getAttr(\"data-avatar-url\"),\n          color: getAttr(\"data-color\"),\n        });\n      }\n    }\n  }\n\n  return mentions;\n}\n","import MarkdownIt from \"markdown-it\";\nimport taskLists from \"markdown-it-task-lists\";\nimport { getEditorText } from \"./plain-text\";\n\nconst md = new MarkdownIt({\n  html: true,\n  linkify: true,\n  breaks: true,\n}).use(taskLists);\n\nconst defaultValidateLink = md.validateLink;\nmd.validateLink = (url: string) => {\n  if (\n    url.startsWith(\"file://\") ||\n    url.startsWith(\"vscode://\") ||\n    url.startsWith(\"cursor://\")\n  ) {\n    return true;\n  }\n  return defaultValidateLink.call(md, url);\n};\n\n/**\n * Converts a markdown string into HTML suitable for TipTap initial content or setContent.\n */\nexport function markdownToTipTapHtml(markdown: string): string {\n  if (!markdown) return \"<p></p>\";\n  return md.render(markdown);\n}\n\n/**\n * Extracts clean markdown from a TipTap editor instance.\n * If the editor has the Markdown extension configured, it uses editor.storage.markdown.getMarkdown().\n * Otherwise, it falls back to getEditorText(editor).\n */\nexport function getEditorMarkdown(editor: any): string {\n  if (!editor) return \"\";\n  if (typeof editor.storage?.markdown?.getMarkdown === \"function\") {\n    return editor.storage.markdown.getMarkdown();\n  }\n  return getEditorText(editor);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/serializers/mentions.ts","../../src/serializers/plain-text.ts","../../src/serializers/markdown.ts"],"sourcesContent":["import { escapeHtml } from \"./plain-text\";\nimport type { MentionEntity } from \"../extensions/mention\";\n\n/**\n * Canonical regex pattern for matching @mentions in plain text or markdown.\n * Supports:\n * - Standard unquoted handles: @username, @user.name, @team_alpha, @sa-1\n * - Quoted handles: @\"John Doe\", &quot;Jane Doe&quot;\n * Unquoted handles exclude trailing punctuation (e.g. @violet. matches \"violet\" without the dot).\n */\nexport const MENTION_REGEX =\n  /(?:^|[\\s>(*_\"';\\\\/[\\]{}~`:]|&quot;|&gt;|&lt;|&amp;)@(?:\"([^\"]+)\"|&quot;([^&]+)&quot;|([a-zA-Z0-9_-]+(?:\\.[a-zA-Z0-9_-]+)*))/g;\n\n/**\n * Split regex identifying markdown code blocks, inline code, URLs, and existing HTML tags.\n * Used by preprocessMarkdownMentions to ensure non-mention regions remain completely untouched.\n */\nexport const MARKDOWN_MENTION_SPLIT_REGEX =\n  /(```[\\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;\n\nexport interface MentionSegment {\n  type: \"text\" | \"mention\";\n  value: string;\n  handle?: string;\n}\n\nexport interface PreprocessMarkdownMentionsOptions {\n  /**\n   * Known pool of mentionable entities (users, agents, teams, etc.).\n   */\n  mentionables?: MentionEntity[];\n  /**\n   * Default entity type assigned when a handle does not match any entry in mentionables.\n   * Defaults to 'user'.\n   */\n  defaultType?: string;\n  /**\n   * Custom resolver callback to derive entity metadata for unmatched handles.\n   */\n  resolveMention?: (handle: string) => Partial<MentionEntity> | null | undefined;\n}\n\n/**\n * Strips code blocks and inline code from markdown or HTML content:\n * - Fenced code blocks: ```...``` and ~~~...~~~\n * - Inline backtick code: `...`\n * - HTML code/pre tags: <pre>...</pre>, <code>...</code>\n * Used to avoid false-positive mention parsing and keyword analysis within code snippets, terminal logs, or stack traces.\n */\nexport function stripMarkdownCode(content: string): string {\n  if (!content || typeof content !== \"string\") return \"\";\n  return content\n    .replace(/```[\\s\\S]*?```/g, \"\")\n    .replace(/~~~[\\s\\S]*?~~~/g, \"\")\n    .replace(/<pre[\\s\\S]*?<\\/pre>/gi, \"\")\n    .replace(/<code[\\s\\S]*?<\\/code>/gi, \"\")\n    .replace(/`[^`\\n]*`/g, \"\");\n}\n\n/**\n * Extracts unique mention handles from a text, markdown, or HTML string,\n * ignoring trailing punctuation, code blocks, URLs, and pre-existing HTML mention attributes.\n */\nexport function extractMentions(content: string): string[] {\n  if (!content || typeof content !== \"string\") return [];\n\n  // Normalize existing HTML mention nodes (e.g. from TipTap or rich text serializers)\n  // so data-mention-suggestion-char=\"@\" does not trigger spurious quoted matches against attributes,\n  // and ensure the actual mentioned label or ID is preserved cleanly.\n  const normalizedMentionNodes = content.replace(\n    /<span\\b[^>]*\\b(?:data-type=[\"']mention[\"']|class=[\"'][^\"']*pixerate-mention-node[^\"']*[\"'])[^>]*>([\\s\\S]*?)<\\/span>/gi,\n    (match, inner) => {\n      const labelMatch = match.match(/\\bdata-label=[\"']([^\"']+)[\"']/i);\n      if (labelMatch) return ` @${labelMatch[1]} `;\n      const idMatch = match.match(/\\bdata-id=[\"']([^\"']+)[\"']/i);\n      if (idMatch) return ` @${idMatch[1]} `;\n      return ` ${inner} `;\n    }\n  );\n\n  const cleanContent = stripMarkdownCode(normalizedMentionNodes);\n  // Strip URLs and markdown link destinations so @package or @handles in URLs are not extracted as mentions\n  const withoutUrls = cleanContent\n    .replace(/(?:https?|ftp|file|vscode|cursor|mailto):\\/\\/[^\\s<>()]+/gi, \"\")\n    .replace(/\\]\\([^)]*\\)/g, \"]\");\n  // Strip remaining HTML tags so attributes containing '@' or '>' aren't treated as mention triggers\n  const textOnly = withoutUrls.replace(/<[^>]+>/g, \" \");\n\n  const mentions: string[] = [];\n  const seen = new Set<string>();\n\n  const regex = new RegExp(MENTION_REGEX.source, \"g\");\n  let match: RegExpExecArray | null;\n\n  while ((match = regex.exec(textOnly)) !== null) {\n    const handle = (match[1] ?? match[2] ?? match[3] ?? \"\").trim();\n    if (handle && !seen.has(handle)) {\n      seen.add(handle);\n      mentions.push(handle);\n    }\n  }\n\n  return mentions;\n}\n\n/**\n * Segments a text string into plain text parts and mention tokens.\n * Correctly leaves trailing punctuation (like \".\") as part of the following text segment.\n */\nexport function parseMentionSegments(content: string): MentionSegment[] {\n  if (!content) return [];\n\n  const segments: MentionSegment[] = [];\n  const regex = new RegExp(MENTION_REGEX.source, \"g\");\n  let lastIndex = 0;\n  let match: RegExpExecArray | null;\n\n  while ((match = regex.exec(content)) !== null) {\n    const fullMatch = match[0];\n    const atIndex = fullMatch.indexOf(\"@\");\n    const prefix = atIndex > 0 ? fullMatch.slice(0, atIndex) : \"\";\n    const mentionToken = fullMatch.slice(atIndex);\n    const handle = match[1] ?? match[2] ?? match[3];\n    const matchStart = match.index + prefix.length;\n\n    if (matchStart > lastIndex) {\n      segments.push({\n        type: \"text\",\n        value: content.slice(lastIndex, matchStart),\n      });\n    }\n\n    segments.push({\n      type: \"mention\",\n      value: mentionToken,\n      handle,\n    });\n\n    lastIndex = matchStart + mentionToken.length;\n  }\n\n  if (lastIndex < content.length) {\n    segments.push({\n      type: \"text\",\n      value: content.slice(lastIndex),\n    });\n  }\n\n  return segments;\n}\n\n/**\n * Preprocesses markdown text by turning raw @mention handles into TipTap-compatible\n * mention HTML spans (<span class=\"pixerate-mention-node\" data-type=\"mention\" ...>),\n * ensuring code blocks, inline code, existing mention nodes, and URLs remain immune.\n */\nexport function preprocessMarkdownMentions(\n  content: string,\n  optionsOrMentionables: MentionEntity[] | PreprocessMarkdownMentionsOptions = []\n): string {\n  if (!content || typeof content !== \"string\") return \"\";\n\n  const options: PreprocessMarkdownMentionsOptions = Array.isArray(optionsOrMentionables)\n    ? { mentionables: optionsOrMentionables }\n    : optionsOrMentionables;\n\n  const allMentionables = options.mentionables || [];\n  const defaultType = options.defaultType || \"user\";\n  const resolveMention = options.resolveMention;\n\n  const parts = content.split(MARKDOWN_MENTION_SPLIT_REGEX);\n\n  return parts\n    .map((part) => {\n      if (!part) return \"\";\n\n      // Preserve code fences, code tags, inline backticks, existing mention spans,\n      // HTML tags, markdown link targets, and raw URLs untouched.\n      if (\n        part.startsWith(\"```\") ||\n        part.startsWith(\"~~~\") ||\n        part.startsWith(\"`\") ||\n        part.startsWith(\"](\") ||\n        /^(?:https?|file|vscode|cursor|mailto):\\/\\//i.test(part) ||\n        /^<pre[\\s>]/i.test(part) ||\n        /^<code[\\s>]/i.test(part) ||\n        /^<[^>]+>$/i.test(part) ||\n        /^<span\\b[^>]*\\b(?:data-type=[\"']mention[\"']|class=[\"'][^\"']*pixerate-mention-node[^\"']*[\"']|data-mention=[\"'][^\"']*[\"'])/i.test(\n          part\n        )\n      ) {\n        return part;\n      }\n\n      const regex = new RegExp(MENTION_REGEX.source, \"g\");\n      return part.replace(regex, (match, quotedHandle, escapedQuotedHandle, standardHandle) => {\n        const atIndex = match.indexOf(\"@\");\n        const prefix = atIndex > 0 ? match.slice(0, atIndex) : \"\";\n        const rawHandle = (quotedHandle || escapedQuotedHandle || standardHandle || \"\").trim();\n        if (!rawHandle) return match;\n\n        const lowerHandle = rawHandle.toLowerCase();\n        const entity = allMentionables.find((e) => {\n          if (e.label?.toLowerCase() === lowerHandle) return true;\n          if (e.handle?.toLowerCase() === lowerHandle) return true;\n          if (e.name?.toLowerCase() === lowerHandle) return true;\n          if (e.id?.toLowerCase() === lowerHandle) return true;\n          if (e.type === \"agent\" && `agent${(e.handle || e.label || \"\").toLowerCase()}` === lowerHandle) return true;\n          if (\n            e.aliases?.some(\n              (a: string) =>\n                a.toLowerCase() === lowerHandle ||\n                (e.type === \"agent\" && `agent${a.toLowerCase()}` === lowerHandle)\n            )\n          ) {\n            return true;\n          }\n          return false;\n        });\n\n        let id = entity?.id;\n        let label = entity?.label || entity?.handle || rawHandle;\n        let type = entity?.type;\n        let avatarUrl = entity?.avatarUrl;\n        let color = entity?.color || entity?.hexColor;\n\n        if (!entity) {\n          const customResolved = resolveMention?.(rawHandle);\n          if (customResolved) {\n            id = customResolved.id ?? id;\n            label = customResolved.label ?? customResolved.handle ?? label;\n            type = customResolved.type ?? type;\n            avatarUrl = customResolved.avatarUrl ?? avatarUrl;\n            color = customResolved.color ?? customResolved.hexColor ?? color;\n          } else {\n            const stripped = lowerHandle.replace(/^agent[\\s\\-_]*/i, \"\");\n            if (\n              [\"supervisor\", \"coordinator\", \"planner\", \"validator\", \"executor\"].includes(stripped)\n            ) {\n              type = \"agent\";\n              id = stripped;\n              label = stripped;\n            } else if (lowerHandle === \"agents\") {\n              type = \"team\";\n              id = \"agents\";\n              label = \"agents\";\n            } else {\n              type = defaultType;\n              id = rawHandle;\n              label = rawHandle;\n            }\n          }\n        }\n\n        const avatarAttr = avatarUrl ? ` data-avatar-url=\"${escapeHtml(avatarUrl)}\"` : \"\";\n        const colorAttr = color ? ` data-color=\"${escapeHtml(color)}\"` : \"\";\n\n        return `${prefix}<span class=\"pixerate-mention-node\" data-type=\"mention\" data-id=\"${escapeHtml(\n          id || label\n        )}\" data-label=\"${escapeHtml(label)}\" data-mention-suggestion-char=\"@\" data-type-name=\"${escapeHtml(\n          type || defaultType\n        )}\"${avatarAttr}${colorAttr}>@${escapeHtml(label)}</span>`;\n      });\n    })\n    .join(\"\");\n}\n","/**\n * Escapes characters that have syntactic meaning in HTML text.\n */\nexport function escapeHtml(text: string): string {\n  if (!text) return \"\";\n  return text\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/'/g, \"&#039;\");\n}\n\n/**\n * Converts a plain-text string with newlines into HTML paragraphs suitable\n * for TipTap initial content or setContent, preserving line breaks.\n */\nexport function plainTextToTipTapHtml(text: string): string {\n  if (!text) return \"<p></p>\";\n  if (/<p[\\s>]/i.test(text)) {\n    return text;\n  }\n  return text\n    .replace(/\\r\\n/g, \"\\n\")\n    .replace(/\\r/g, \"\\n\")\n    .split(\"\\n\")\n    .map((line) => `<p>${escapeHtml(line)}</p>`)\n    .join(\"\");\n}\n\n/**\n * Extracts plain text from an HTML string or TipTap HTML, preserving newlines between block tags.\n */\nexport function htmlToPlainText(html: string): string {\n  if (!html) return \"\";\n\n  // Normalize mentions so data-label is preserved as @label even if textContent is empty\n  const mentionNormalized = html\n    .replace(\n      /<span[^>]*data-type=[\"']mention[\"'][^>]*data-label=[\"']([^\"']+)[\"'][^>]*>.*?<\\/span>/gi,\n      \"@$1\",\n    )\n    .replace(\n      /<span[^>]*data-type=[\"']mention[\"'][^>]*data-id=[\"']([^\"']+)[\"'][^>]*>.*?<\\/span>/gi,\n      \"@$1\",\n    );\n\n  if (typeof document !== \"undefined\") {\n    const tempDiv = document.createElement(\"div\");\n    tempDiv.innerHTML = mentionNormalized;\n    tempDiv\n      .querySelectorAll(\"br.ProseMirror-trailingBreak\")\n      .forEach((br) => br.remove());\n    tempDiv.querySelectorAll(\"br\").forEach((br) => br.replaceWith(\"\\n\"));\n    const paragraphs = tempDiv.querySelectorAll(\"p, div, li, h1, h2, h3, h4, h5, h6\");\n    if (paragraphs.length > 0) {\n      const textParts: string[] = [];\n      paragraphs.forEach((p) => {\n        textParts.push(p.textContent || \"\");\n      });\n      return textParts.join(\"\\n\");\n    }\n    return tempDiv.textContent || \"\";\n  }\n\n  // Node.js fallback regex\n  return mentionNormalized\n    .replace(/<br\\s*\\/?>/gi, \"\\n\")\n    .replace(/<\\/p>/gi, \"\\n\")\n    .replace(/<\\/div>/gi, \"\\n\")\n    .replace(/<\\/li>/gi, \"\\n\")\n    .replace(/<[^>]+>/g, \"\")\n    .replace(/&amp;/g, \"&\")\n    .replace(/&lt;/g, \"<\")\n    .replace(/&gt;/g, \">\")\n    .replace(/&quot;/g, '\"')\n    .replace(/&#039;/g, \"'\")\n    .trim();\n}\n\n/**\n * Extracts plain text from a TipTap editor instance, preserving newline separators\n * between block nodes and converting mention nodes to @label.\n */\nexport function getEditorText(editor: any): string {\n  if (!editor) return \"\";\n  const html = typeof editor.getHTML === \"function\" ? editor.getHTML() : \"\";\n  if (html) {\n    return htmlToPlainText(html);\n  }\n  if (typeof editor.getText === \"function\") {\n    try {\n      return editor.getText({ blockSeparator: \"\\n\" });\n    } catch {\n      return editor.getText();\n    }\n  }\n  return \"\";\n}\n\nexport interface ExtractedMention {\n  id: string;\n  label: string;\n  type?: string;\n  avatarUrl?: string;\n  color?: string;\n  [key: string]: any;\n}\n\nimport { extractMentions } from \"./mentions\";\n\n/**\n * Traverses an editor instance, ProseMirror document, JSONContent, or HTML string\n * and extracts all mention attributes without needing regex.\n */\nexport function extractMentionsFromDoc(docOrEditor: any): ExtractedMention[] {\n  if (!docOrEditor) return [];\n  const mentions: ExtractedMention[] = [];\n\n  // TipTap editor or ProseMirror Node with .descendants()\n  const doc =\n    docOrEditor?.state?.doc ||\n    (typeof docOrEditor?.descendants === \"function\" ? docOrEditor : null);\n\n  if (doc && typeof doc.descendants === \"function\") {\n    doc.descendants((node: any) => {\n      if (node.type?.name === \"mention\" && node.attrs) {\n        mentions.push({\n          id: node.attrs.id || \"\",\n          label: node.attrs.label || \"\",\n          type: node.attrs.type,\n          avatarUrl: node.attrs.avatarUrl,\n          color: node.attrs.color,\n          ...node.attrs,\n        });\n      }\n    });\n    return mentions;\n  }\n\n  // JSONContent tree\n  if (typeof docOrEditor === \"object\" && docOrEditor.content) {\n    const walk = (nodes: any[]) => {\n      for (const node of nodes) {\n        if (node.type === \"mention\" && node.attrs) {\n          mentions.push({\n            id: node.attrs.id || \"\",\n            label: node.attrs.label || \"\",\n            type: node.attrs.type,\n            avatarUrl: node.attrs.avatarUrl,\n            color: node.attrs.color,\n            ...node.attrs,\n          });\n        }\n        if (Array.isArray(node.content)) {\n          walk(node.content);\n        }\n      }\n    };\n    walk(docOrEditor.content);\n    return mentions;\n  }\n\n  // HTML String\n  if (typeof docOrEditor === \"string\") {\n    if (typeof document !== \"undefined\") {\n      const div = document.createElement(\"div\");\n      div.innerHTML = docOrEditor;\n      div.querySelectorAll('span[data-type=\"mention\"]').forEach((el) => {\n        mentions.push({\n          id: el.getAttribute(\"data-id\") || \"\",\n          label: el.getAttribute(\"data-label\") || \"\",\n          type: el.getAttribute(\"data-type-name\") || undefined,\n          avatarUrl: el.getAttribute(\"data-avatar-url\") || undefined,\n          color: el.getAttribute(\"data-color\") || undefined,\n        });\n      });\n    } else {\n      const spanRegex = /<span([^>]*data-type=[\"']mention[\"'][^>]*)>/gi;\n      let match;\n      while ((match = spanRegex.exec(docOrEditor)) !== null) {\n        const attrStr = match[1];\n        const getAttr = (name: string) => {\n          const m = new RegExp(`${name}=[\"']([^\"']*)[\"']`, \"i\").exec(attrStr);\n          return m ? m[1] : undefined;\n        };\n        mentions.push({\n          id: getAttr(\"data-id\") || \"\",\n          label: getAttr(\"data-label\") || \"\",\n          type: getAttr(\"data-type-name\") || getAttr(\"data-entity-type\"),\n          avatarUrl: getAttr(\"data-avatar-url\"),\n          color: getAttr(\"data-color\"),\n        });\n      }\n    }\n\n    // Fallback: If no HTML mention tags were found, extract raw @mentions from text or markdown\n    if (mentions.length === 0) {\n      const rawHandles = extractMentions(docOrEditor);\n      for (const handle of rawHandles) {\n        mentions.push({\n          id: handle,\n          label: handle,\n          type: \"user\",\n        });\n      }\n    }\n  }\n\n  return mentions;\n}\n","import MarkdownIt from \"markdown-it\";\nimport taskLists from \"markdown-it-task-lists\";\nimport { getEditorText } from \"./plain-text\";\n\nconst md = new MarkdownIt({\n  html: true,\n  linkify: true,\n  breaks: true,\n}).use(taskLists);\n\nconst defaultValidateLink = md.validateLink;\nmd.validateLink = (url: string) => {\n  if (\n    url.startsWith(\"file://\") ||\n    url.startsWith(\"vscode://\") ||\n    url.startsWith(\"cursor://\")\n  ) {\n    return true;\n  }\n  return defaultValidateLink.call(md, url);\n};\n\nimport {\n  preprocessMarkdownMentions,\n  type PreprocessMarkdownMentionsOptions,\n} from \"./mentions\";\nimport type { MentionEntity } from \"../extensions/mention\";\n\n/**\n * Preprocesses file-protocol and editor-protocol links in markdown content:\n * converts [label](file://...), vscode://, and cursor:// links into anchor tags\n * annotated with data-file-link=\"true\", preserving code backticks in labels.\n */\nexport function preprocessMarkdownFileLinks(content: string): string {\n  if (!content) return \"\";\n  return content.replace(\n    /\\[([^\\]]+)\\]\\(((?:file|vscode|cursor):\\/\\/[^)]+)\\)/g,\n    (_match, rawLabel, href) => {\n      const trimmed = rawLabel.trim();\n      const codeMatch = trimmed.match(/^`([^`]+)`$/);\n      const labelContent = codeMatch ? `<code>${codeMatch[1]}</code>` : trimmed;\n      return `<a href=\"${href}\" data-file-link=\"true\" title=\"Click to copy file path\">${labelContent}</a>`;\n    }\n  );\n}\n\nexport interface MarkdownToHtmlOptions {\n  /**\n   * Preprocess file, vscode, and cursor links into clickable data-file-link tags.\n   */\n  preprocessFileLinks?: boolean;\n  /**\n   * Whether to preprocess @mentions into TipTap mention node HTML spans.\n   */\n  preprocessMentions?: boolean;\n  /**\n   * Pool of mentionables to pass to preprocessMarkdownMentions.\n   */\n  mentionables?: MentionEntity[];\n  /**\n   * Full options for preprocessMarkdownMentions.\n   */\n  preprocessOptions?: PreprocessMarkdownMentionsOptions;\n}\n\n/**\n * Converts a markdown string into HTML suitable for TipTap initial content or setContent.\n */\nexport function markdownToTipTapHtml(\n  markdown: string,\n  options?: MarkdownToHtmlOptions\n): string {\n  if (!markdown) return \"<p></p>\";\n  let content = markdown;\n  if (options?.preprocessFileLinks) {\n    content = preprocessMarkdownFileLinks(content);\n  }\n  if (\n    options?.preprocessMentions ||\n    options?.mentionables ||\n    options?.preprocessOptions\n  ) {\n    const mentionOpts = options.preprocessOptions || {\n      mentionables: options.mentionables,\n    };\n    content = preprocessMarkdownMentions(content, mentionOpts);\n  }\n  return md.render(content);\n}\n\n/**\n * Extracts clean markdown from a TipTap editor instance.\n * If the editor has the Markdown extension configured, it uses editor.storage.markdown.getMarkdown().\n * Otherwise, it falls back to getEditorText(editor).\n */\nexport function getEditorMarkdown(editor: any): string {\n  if (!editor) return \"\";\n  if (typeof editor.storage?.markdown?.getMarkdown === \"function\") {\n    return editor.storage.markdown.getMarkdown();\n  }\n  return getEditorText(editor);\n}\n"],"mappings":"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","names":["match"]}

package/dist/types-lGtRobRV.d.cts

@@ -0,0 +1,213 @@
+/**
+ * Generic coordinate and boundary primitives.
+ */
+interface XYPosition {
+    x: number;
+    y: number;
+}
+type Point = readonly [number, number];
+interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+type Position = 'top' | 'right' | 'bottom' | 'left';
+type Side = 'right' | 'below' | 'left' | 'above';
+/**
+ * Generic canvas node structure compatible across SvelteFlow and ReactFlow.
+ */
+interface CanvasNode<TData extends Record<string, any> = Record<string, any>, TType extends string | undefined = string | undefined> {
+    id: string;
+    position: XYPosition;
+    data: TData;
+    type?: TType;
+    selected?: boolean;
+    draggable?: boolean;
+    selectable?: boolean;
+    deletable?: boolean;
+    parentId?: string;
+    width?: number;
+    height?: number;
+    measured?: {
+        width?: number;
+        height?: number;
+    };
+    style?: string;
+    className?: string;
+    class?: string;
+    [key: string]: any;
+}
+/**
+ * Generic canvas edge structure.
+ */
+interface CanvasEdge<TData extends Record<string, any> = Record<string, any>, TType extends string | undefined = string | undefined> {
+    id: string;
+    source: string;
+    target: string;
+    sourceHandle?: string | null;
+    targetHandle?: string | null;
+    data?: TData;
+    type?: TType;
+    label?: string;
+    selected?: boolean;
+    animated?: boolean;
+    style?: string;
+    [key: string]: any;
+}
+/**
+ * Differences computed between two graph states.
+ */
+interface GraphDifferences<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> {
+    changedNodes: TNode[];
+    changedEdges: TEdge[];
+    removedNodes: TNode[];
+    removedEdges: TEdge[];
+}
+/**
+ * Standard serialized clipboard payload for nodes and optional edges.
+ */
+interface CanvasClipboardPayload<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> {
+    version?: number;
+    nodes: TNode[];
+    edges?: TEdge[];
+}
+/**
+ * Options for Dagre graph layout.
+ */
+interface CanvasLayoutOptions {
+    direction?: 'LR' | 'TB' | 'RL' | 'BT';
+    ranksep?: number;
+    nodesep?: number;
+    defaultNodeWidth?: number;
+    defaultNodeHeight?: number;
+}
+/**
+ * Incremental layout options.
+ */
+interface IncrementalLayoutOptions extends CanvasLayoutOptions {
+    /**
+     * Stored known coordinates for nodes, e.g. from user manual layout or persistence.
+     */
+    storedPositions?: Record<string, XYPosition>;
+}
+/**
+ * Options for directional collision-aware placement.
+ */
+interface PlaceBesideOptions {
+    gap?: number;
+    ignore?: string[];
+    stepIncrement?: number;
+    maxAttempts?: number;
+}
+/**
+ * Parametric point returned by a trajectory evaluation.
+ */
+interface TrajectoryPoint {
+    position: XYPosition;
+    scale?: number;
+    opacity?: number;
+}
+/**
+ * Trajectory evaluation function determining path, scale, and opacity over time t in [0, 1].
+ */
+type TrajectoryFunction = (origin: XYPosition, target: XYPosition, progress: number, index: number, total: number) => TrajectoryPoint;
+/**
+ * Options for fan-out trajectory generator.
+ */
+interface FanOutTrajectoryOptions {
+    curvature?: number;
+    spreadAngle?: number;
+    startScale?: number;
+    endScale?: number;
+    startOpacity?: number;
+    endOpacity?: number;
+}
+/**
+ * Single node animation transition definition.
+ */
+interface NodeTransition<TNode extends CanvasNode = CanvasNode> {
+    node: TNode;
+    from: XYPosition;
+    to: XYPosition;
+    trajectory?: TrajectoryFunction;
+    delay?: number;
+    duration?: number;
+    easing?: (t: number) => number;
+    index?: number;
+    total?: number;
+}
+/**
+ * Displacement axis / direction.
+ */
+type DisplacementDirection = 'right' | 'left' | 'down' | 'up' | 'vertical';
+/**
+ * Options for directional displacement calculation.
+ */
+interface DirectionalDisplacementOptions {
+    direction?: DisplacementDirection;
+    gap?: number;
+    spreadSiblingLanes?: boolean;
+    siblingTolerance?: number;
+    minY?: number;
+}
+/**
+ * Options for Dagre reflow displacement calculation.
+ */
+interface ReflowDisplacementOptions extends CanvasLayoutOptions {
+    anchorNodeId: string;
+}
+/**
+ * Snapshot of canvas graph state prior to node explosion, enabling exact reversibility.
+ */
+interface ExplosionSnapshot<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> {
+    parentId: string;
+    childNodeIds: string[];
+    childEdgeIds: string[];
+    displacedNodes: {
+        id: string;
+        originalPosition: XYPosition;
+    }[];
+    timestamp: number;
+}
+/**
+ * Options for exploding a node.
+ */
+interface ExplodeNodeOptions<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> {
+    childNodes: TNode[];
+    childEdges?: TEdge[];
+    connectParentToChildren?: boolean | 'first' | 'all';
+    connectChildrenToDownstream?: boolean;
+    displacementStrategy?: 'directional' | 'dagre' | 'none';
+    directionalOptions?: DirectionalDisplacementOptions;
+    reflowOptions?: Partial<ReflowDisplacementOptions>;
+    trajectory?: TrajectoryFunction;
+    duration?: number;
+    staggerDelay?: number;
+    easing?: (t: number) => number;
+    onComplete?: () => void;
+}
+/**
+ * Options for collapsing an exploded node.
+ */
+interface CollapseNodeOptions {
+    duration?: number;
+    staggerDelay?: number;
+    easing?: (t: number) => number;
+    trajectory?: TrajectoryFunction;
+    onComplete?: () => void;
+}
+/**
+ * Strategy used to resolve the primary dock target when multiple targets intersect a dragged node.
+ */
+type DockStrategy = 'center-point' | 'max-overlap' | 'pointer' | 'first';
+/**
+ * Docking and intersection callbacks.
+ */
+interface CanvasDockingCallbacks<TNode extends CanvasNode = CanvasNode> {
+    onDockHover?: (dockTarget: TNode, draggedNode: TNode) => void;
+    onDockLeave?: (dockTarget: TNode, draggedNode: TNode) => void;
+    onDockDrop?: (dockTarget: TNode, draggedNode: TNode) => void;
+}
+
+export type { CanvasClipboardPayload as C, DirectionalDisplacementOptions as D, ExplodeNodeOptions as E, FanOutTrajectoryOptions as F, GraphDifferences as G, IncrementalLayoutOptions as I, NodeTransition as N, PlaceBesideOptions as P, Rect as R, Side as S, TrajectoryFunction as T, XYPosition as X, CanvasDockingCallbacks as a, CanvasEdge as b, CanvasLayoutOptions as c, CanvasNode as d, CollapseNodeOptions as e, DisplacementDirection as f, DockStrategy as g, ExplosionSnapshot as h, Point as i, Position as j, ReflowDisplacementOptions as k, TrajectoryPoint as l };