@pixerate/editor 0.24.0 → 0.26.0

package/dist/chunk-O5RYH2PG.js

@@ -0,0 +1,69 @@
+// src/serializers/mention-text.ts
+var MENTION_REGEX = /(?:^|[\s>(*_"';\\/[\]{}~`:]|"|>|<|&)@(?:"([^"]+)"|"([^&]+)"|([a-zA-Z0-9_-]+(?:\.[a-zA-Z0-9_-]+)*))/g;
+var NODE_ROLE_MARK = "
";
+var ROLE_SUFFIX_REGEX = /[:\u0001]([A-Za-z](?:[A-Za-z0-9_-]*[A-Za-z0-9])?)(?![A-Za-z0-9])/y;
+var PLAIN_HANDLE_REGEX = /^[a-zA-Z0-9_-]+(?:\.[a-zA-Z0-9_-]+)*$/;
+function readRoleSuffix(text, index, roles) {
+  const first = text.charAt(index);
+  if (first !== ":" && first !== NODE_ROLE_MARK) return null;
+  if (first === ":" && !roles) return null;
+  ROLE_SUFFIX_REGEX.lastIndex = index;
+  const match = ROLE_SUFFIX_REGEX.exec(text);
+  if (!match) return null;
+  let role = match[1];
+  if (first === ":" && roles !== true) {
+    const lower = role.toLowerCase();
+    const listed = roles.find((r) => r.toLowerCase() === lower);
+    if (listed === void 0) return null;
+    role = listed;
+  }
+  return { role, end: index + match[0].length };
+}
+function formatMentionHandle(label) {
+  return PLAIN_HANDLE_REGEX.test(label) || label.includes('"') ? `@${label}` : `@"${label}"`;
+}
+function formatMentionText(handle, role) {
+  return role ? `${formatMentionHandle(handle)}:${role}` : formatMentionHandle(handle);
+}
+function findTextMentions(text, options = {}) {
+  if (!text || typeof text !== "string") return [];
+  const roles = options.roles === false ? void 0 : options.roles ?? true;
+  const result = [];
+  const regex = new RegExp(MENTION_REGEX.source, "g");
+  let match;
+  while ((match = regex.exec(text)) !== null) {
+    const handle = match[1] ?? match[2] ?? match[3] ?? "";
+    const start = match.index + match[0].indexOf("@");
+    const handleEnd = regex.lastIndex;
+    const suffix = text.charAt(handleEnd) === ":" ? readRoleSuffix(text, handleEnd, roles) : null;
+    if (suffix) regex.lastIndex = suffix.end;
+    result.push({
+      handle,
+      ...suffix ? { role: suffix.role } : {},
+      start,
+      end: suffix ? suffix.end : handleEnd,
+      handleEnd
+    });
+  }
+  return result;
+}
+function setMentionRoleInText(text, start, role, options = {}) {
+  const mention = findTextMentions(text, { roles: options.roles ?? true }).find((m) => m.start === start);
+  if (!mention) return text;
+  if (role !== null && !/^[A-Za-z](?:[A-Za-z0-9_-]*[A-Za-z0-9])?$/.test(role)) {
+    throw new Error(`Invalid mention role "${role}".`);
+  }
+  const suffix = role ? `:${role}` : "";
+  return text.slice(0, mention.handleEnd) + suffix + text.slice(mention.end);
+}
+
+export {
+  MENTION_REGEX,
+  NODE_ROLE_MARK,
+  readRoleSuffix,
+  formatMentionHandle,
+  formatMentionText,
+  findTextMentions,
+  setMentionRoleInText
+};
+//# sourceMappingURL=chunk-O5RYH2PG.js.map

package/dist/chunk-O5RYH2PG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/serializers/mention-text.ts"],"sourcesContent":["/**\n * Dependency-free mention text helpers: the `@handle` pattern, the opt-in\n * `@handle:role` suffix used by asset mentions, and offset-based editing of\n * mentions in plain prompt text. Kept apart from `mentions.ts` (which pulls in\n * the HTML serializers) so `@pixerate/editor/generation` can re-export them.\n */\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\", "Jane Doe"\n * Unquoted handles exclude trailing punctuation (e.g. @violet. matches \"violet\" without the dot).\n */\nexport const MENTION_REGEX =\n  /(?:^|[\\s>(*_\"';\\\\/[\\]{}~`:]|"|>|<|&)@(?:\"([^\"]+)\"|"([^&]+)"|([a-zA-Z0-9_-]+(?:\\.[a-zA-Z0-9_-]+)*))/g;\n\n/**\n * Which `@handle:role` suffixes are read as a mention role: `true` for any\n * role name, or a list of accepted roles (matched case-insensitively and\n * returned as listed). Off by default, so `@john:` text is unchanged.\n */\nexport type MentionRoleSyntax = true | readonly string[];\n\n/** Marks a role taken from a mention node's `data-role` while extracting (never in output). */\nexport const NODE_ROLE_MARK = \"\\u0001\";\nconst ROLE_SUFFIX_REGEX = /[:\\u0001]([A-Za-z](?:[A-Za-z0-9_-]*[A-Za-z0-9])?)(?![A-Za-z0-9])/y;\nconst PLAIN_HANDLE_REGEX = /^[a-zA-Z0-9_-]+(?:\\.[a-zA-Z0-9_-]+)*$/;\n\n/**\n * Reads a `:role` suffix at `index`. Returns the role (as listed in `roles`)\n * and the index after it, or `null`. A suffix taken from a mention node\n * (`NODE_ROLE_MARK`) is accepted whatever `roles` says.\n */\nexport function readRoleSuffix(\n  text: string,\n  index: number,\n  roles: MentionRoleSyntax | undefined,\n): { role: string; end: number } | null {\n  const first = text.charAt(index);\n  if (first !== \":\" && first !== NODE_ROLE_MARK) return null;\n  if (first === \":\" && !roles) return null;\n  ROLE_SUFFIX_REGEX.lastIndex = index;\n  const match = ROLE_SUFFIX_REGEX.exec(text);\n  if (!match) return null;\n  let role = match[1];\n  if (first === \":\" && roles !== true) {\n    const lower = role.toLowerCase();\n    const listed = (roles as readonly string[]).find((r) => r.toLowerCase() === lower);\n    if (listed === undefined) return null;\n    role = listed;\n  }\n  return { role, end: index + match[0].length };\n}\n\n/** `@label`, quoted when the label is not a plain handle (and has no `\"`). */\nexport function formatMentionHandle(label: string): string {\n  return PLAIN_HANDLE_REGEX.test(label) || label.includes('\"') ? `@${label}` : `@\"${label}\"`;\n}\n\n/**\n * Formats a mention as text: `@handle` or `@handle:role` (quoted as\n * `@\"Two words\":role` when the handle is not a plain handle).\n */\nexport function formatMentionText(handle: string, role?: string | null): string {\n  return role ? `${formatMentionHandle(handle)}:${role}` : formatMentionHandle(handle);\n}\n\n/** A mention found in plain text, with offsets into that text. */\nexport interface TextMention {\n  handle: string;\n  role?: string;\n  /** Offset of the `@`. */\n  start: number;\n  /** Offset just past the handle (and role, when present). */\n  end: number;\n  /** Offset just past the handle (where a `:role` suffix starts). */\n  handleEnd: number;\n}\n\n/**\n * Every mention in plain text (prompt text), in order, with offsets and\n * `@handle:role` roles (`roles` defaults to `true` here). Unlike\n * {@link extractMentions} it does not skip code or URLs and keeps duplicates.\n */\nexport function findTextMentions(text: string, options: { roles?: MentionRoleSyntax | false } = {}): TextMention[] {\n  if (!text || typeof text !== \"string\") return [];\n  const roles = options.roles === false ? undefined : (options.roles ?? true);\n  const result: TextMention[] = [];\n  const regex = new RegExp(MENTION_REGEX.source, \"g\");\n  let match: RegExpExecArray | null;\n  while ((match = regex.exec(text)) !== null) {\n    const handle = match[1] ?? match[2] ?? match[3] ?? \"\";\n    const start = match.index + match[0].indexOf(\"@\");\n    const handleEnd = regex.lastIndex;\n    const suffix = text.charAt(handleEnd) === \":\" ? readRoleSuffix(text, handleEnd, roles) : null;\n    if (suffix) regex.lastIndex = suffix.end;\n    result.push({\n      handle,\n      ...(suffix ? { role: suffix.role } : {}),\n      start,\n      end: suffix ? suffix.end : handleEnd,\n      handleEnd,\n    });\n  }\n  return result;\n}\n\n/**\n * Sets (or with `null` removes) the `:role` of the text mention starting at\n * offset `start` (its `@`). Returns the text unchanged when no mention starts there.\n */\nexport function setMentionRoleInText(\n  text: string,\n  start: number,\n  role: string | null,\n  options: { roles?: MentionRoleSyntax } = {},\n): string {\n  const mention = findTextMentions(text, { roles: options.roles ?? true }).find((m) => m.start === start);\n  if (!mention) return text;\n  if (role !== null && !/^[A-Za-z](?:[A-Za-z0-9_-]*[A-Za-z0-9])?$/.test(role)) {\n    throw new Error(`Invalid mention role \"${role}\".`);\n  }\n  const suffix = role ? `:${role}` : \"\";\n  return text.slice(0, mention.handleEnd) + suffix + text.slice(mention.end);\n}\n\n"],"mappings":";AAcO,IAAM,gBACX;AAUK,IAAM,iBAAiB;AAC9B,IAAM,oBAAoB;AAC1B,IAAM,qBAAqB;AAOpB,SAAS,eACd,MACA,OACA,OACsC;AACtC,QAAM,QAAQ,KAAK,OAAO,KAAK;AAC/B,MAAI,UAAU,OAAO,UAAU,eAAgB,QAAO;AACtD,MAAI,UAAU,OAAO,CAAC,MAAO,QAAO;AACpC,oBAAkB,YAAY;AAC9B,QAAM,QAAQ,kBAAkB,KAAK,IAAI;AACzC,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,OAAO,MAAM,CAAC;AAClB,MAAI,UAAU,OAAO,UAAU,MAAM;AACnC,UAAM,QAAQ,KAAK,YAAY;AAC/B,UAAM,SAAU,MAA4B,KAAK,CAAC,MAAM,EAAE,YAAY,MAAM,KAAK;AACjF,QAAI,WAAW,OAAW,QAAO;AACjC,WAAO;AAAA,EACT;AACA,SAAO,EAAE,MAAM,KAAK,QAAQ,MAAM,CAAC,EAAE,OAAO;AAC9C;AAGO,SAAS,oBAAoB,OAAuB;AACzD,SAAO,mBAAmB,KAAK,KAAK,KAAK,MAAM,SAAS,GAAG,IAAI,IAAI,KAAK,KAAK,KAAK,KAAK;AACzF;AAMO,SAAS,kBAAkB,QAAgB,MAA8B;AAC9E,SAAO,OAAO,GAAG,oBAAoB,MAAM,CAAC,IAAI,IAAI,KAAK,oBAAoB,MAAM;AACrF;AAmBO,SAAS,iBAAiB,MAAc,UAAiD,CAAC,GAAkB;AACjH,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO,CAAC;AAC/C,QAAM,QAAQ,QAAQ,UAAU,QAAQ,SAAa,QAAQ,SAAS;AACtE,QAAM,SAAwB,CAAC;AAC/B,QAAM,QAAQ,IAAI,OAAO,cAAc,QAAQ,GAAG;AAClD,MAAI;AACJ,UAAQ,QAAQ,MAAM,KAAK,IAAI,OAAO,MAAM;AAC1C,UAAM,SAAS,MAAM,CAAC,KAAK,MAAM,CAAC,KAAK,MAAM,CAAC,KAAK;AACnD,UAAM,QAAQ,MAAM,QAAQ,MAAM,CAAC,EAAE,QAAQ,GAAG;AAChD,UAAM,YAAY,MAAM;AACxB,UAAM,SAAS,KAAK,OAAO,SAAS,MAAM,MAAM,eAAe,MAAM,WAAW,KAAK,IAAI;AACzF,QAAI,OAAQ,OAAM,YAAY,OAAO;AACrC,WAAO,KAAK;AAAA,MACV;AAAA,MACA,GAAI,SAAS,EAAE,MAAM,OAAO,KAAK,IAAI,CAAC;AAAA,MACtC;AAAA,MACA,KAAK,SAAS,OAAO,MAAM;AAAA,MAC3B;AAAA,IACF,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAMO,SAAS,qBACd,MACA,OACA,MACA,UAAyC,CAAC,GAClC;AACR,QAAM,UAAU,iBAAiB,MAAM,EAAE,OAAO,QAAQ,SAAS,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,KAAK;AACtG,MAAI,CAAC,QAAS,QAAO;AACrB,MAAI,SAAS,QAAQ,CAAC,2CAA2C,KAAK,IAAI,GAAG;AAC3E,UAAM,IAAI,MAAM,yBAAyB,IAAI,IAAI;AAAA,EACnD;AACA,QAAM,SAAS,OAAO,IAAI,IAAI,KAAK;AACnC,SAAO,KAAK,MAAM,GAAG,QAAQ,SAAS,IAAI,SAAS,KAAK,MAAM,QAAQ,GAAG;AAC3E;","names":[]}