@pixerate/editor 0.24.0 → 0.25.0

package/dist/persistence/index.d.ts

@@ -1,3 +1,5 @@
+import { S as StorageAdapter } from '../storage-BpFfspHm.js';
+export { I as IdbFactoryLike, a as IndexedDbAdapterOptions, b as InjectedStorageError, L as LocalStorageAdapterOptions, M as MemoryStorage, O as OpfsAdapterOptions, c as OpfsDirectoryLike, d as OpfsFileLike, e as StorageAdapterOptions, f as StorageFailureMode, g as StorageOperation, h as StorageUnavailableError, W as WebStorageLike, i as createIndexedDbAdapter, j as createLocalStorageAdapter, k as createMemoryStorage, l as createOpfsAdapter, m as isIndexedDbAvailable, n as isLocalStorageAvailable, o as isOpfsAvailable, w as withStorageFailures } from '../storage-BpFfspHm.js';
 export { J as JsonObject, L as LoadDocumentOptions, a as LoadDocumentResult, b as LoadReport, c as LoadSectionsOptions, d as LoadSectionsResult, M as MigrateOptions, e as MigrateResult, f as MigrationStep, R as ReadOnlyReason, S as SectionProblem, g as SectionSpec, h as SectionSpecs, i as createLoadReport, j as hasLoadProblems, l as loadDocument, k as loadSections, m as migrateDocument } from '../migrate-iTlm3a8h.js';
 
 /**
@@ -63,125 +65,6 @@ declare function exponentialBackoff(failures: number, base?: number, max?: numbe
  */
 declare function createRecoveryPolicy(options?: RecoveryPolicyOptions): RecoveryPolicy;
 
-/**
- * Key/value storage adapters for autosave and crash recovery. Every adapter is
- * async, stores strings, feature-detects its backend (an unavailable backend
- * rejects every call with `StorageUnavailableError` instead of throwing at
- * construction, so SSR and old browsers are safe) and accepts an injectable
- * failure mode for tests.
- */
-type StorageOperation = "get" | "set" | "remove";
-/**
- * Injected failure: return `true` (or an `Error`) to make that operation fail.
- * Example: `failure: (op) => op === "set"` simulates a full disk.
- */
-type StorageFailureMode = (operation: StorageOperation, key: string) => boolean | Error | undefined | void;
-interface StorageAdapter {
-    /** Short backend name, e.g. `"memory"`, `"localStorage"`, `"indexedDB"`, `"opfs"`. */
-    readonly kind: string;
-    /** Whether the backend was found. When `false`, every call rejects. */
-    readonly available: boolean;
-    get(key: string): Promise<string | null>;
-    set(key: string, value: string): Promise<void>;
-    remove(key: string): Promise<void>;
-}
-interface StorageAdapterOptions {
-    failure?: StorageFailureMode;
-}
-declare class StorageUnavailableError extends Error {
-    constructor(kind: string);
-}
-declare class InjectedStorageError extends Error {
-    constructor(operation: StorageOperation, key: string);
-}
-/** Wraps an adapter so `failure` can make any of its operations fail. */
-declare function withStorageFailures(inner: StorageAdapter, failure: StorageFailureMode): StorageAdapter;
-interface MemoryStorage extends StorageAdapter {
-    /** The underlying map (inspect it in tests). */
-    readonly entries: Map<string, string>;
-}
-/** In-memory storage (tests, SSR, or a session-only fallback). */
-declare function createMemoryStorage(options?: StorageAdapterOptions & {
-    initial?: Record<string, string>;
-}): MemoryStorage;
-/** Minimal `Storage` surface used by the localStorage adapter. */
-interface WebStorageLike {
-    getItem(key: string): string | null;
-    setItem(key: string, value: string): void;
-    removeItem(key: string): void;
-}
-interface LocalStorageAdapterOptions extends StorageAdapterOptions {
-    /** Storage to use (default `globalThis.localStorage`, e.g. pass `sessionStorage`). */
-    storage?: WebStorageLike;
-}
-/** Whether `localStorage` can be used (it throws when site data is blocked). */
-declare function isLocalStorageAvailable(): boolean;
-/**
- * `localStorage` adapter; every key is prefixed with `prefix`. Writes are
- * synchronous under the hood, so they complete even inside `pagehide`.
- * A full quota rejects the `set` (`QuotaExceededError`).
- */
-declare function createLocalStorageAdapter(prefix?: string, options?: LocalStorageAdapterOptions): StorageAdapter;
-/** Minimal `IDBFactory` surface (the real `indexedDB`, or a fake in tests). */
-interface IdbFactoryLike {
-    open(name: string, version?: number): any;
-}
-interface IndexedDbAdapterOptions extends StorageAdapterOptions {
-    /** Object store name (default `"kv"`). */
-    store?: string;
-    /** Factory to use (default `globalThis.indexedDB`). */
-    indexedDB?: IdbFactoryLike;
-}
-/** Whether `indexedDB` exists in this environment. */
-declare function isIndexedDbAvailable(): boolean;
-/**
- * IndexedDB adapter: one database `name` with a single key/value object store.
- * A `set` resolves when its transaction completes (not merely when the request
- * succeeds), so a resolved write is durable.
- */
-declare function createIndexedDbAdapter(name?: string, options?: IndexedDbAdapterOptions): StorageAdapter;
-/** Minimal `FileSystemDirectoryHandle` surface used by the OPFS adapter. */
-interface OpfsDirectoryLike {
-    getDirectoryHandle(name: string, options?: {
-        create?: boolean;
-    }): Promise<OpfsDirectoryLike>;
-    getFileHandle(name: string, options?: {
-        create?: boolean;
-    }): Promise<OpfsFileLike>;
-    removeEntry(name: string): Promise<void>;
-}
-interface OpfsFileLike {
-    getFile(): Promise<{
-        text(): Promise<string>;
-    }>;
-    createWritable?(): Promise<{
-        write(data: string): Promise<void>;
-        close(): Promise<void>;
-    }>;
-    /** Rename in place (Chromium, Safari). Used for temp-file + rename writes. */
-    move?(name: string): Promise<void>;
-}
-interface OpfsAdapterOptions extends StorageAdapterOptions {
-    /** Root directory (default `navigator.storage.getDirectory()`). */
-    root?: () => Promise<OpfsDirectoryLike>;
-    /** Force the write-then-pointer-swap strategy even when `move` exists. */
-    disableRename?: boolean;
-}
-/** Whether the Origin Private File System exists (`navigator.storage.getDirectory`). */
-declare function isOpfsAvailable(): boolean;
-/**
- * Origin Private File System adapter. Values are files in `dir` (created on
- * demand), named after the URI-encoded key.
- *
- * Writes never leave a half-written value behind: where file handles support
- * `move`, the value is written to `<file>.tmp` and renamed over `<file>`;
- * otherwise it alternates between two slots (`<file>.a` / `<file>.b`) and then
- * swaps a pointer file (`<file>.ptr`), so a crash mid-write keeps the previous
- * value. Main-thread writes need `createWritable` (missing in some Safari
- * versions); without it, `set` rejects with `StorageUnavailableError`.
- */
-declare function createOpfsAdapter(dir?: string, options?: OpfsAdapterOptions): StorageAdapter;
-
 type AutosaveStatus = "idle" | "dirty" | "saving" | "saved" | "error";
 interface AutosaveStatusInfo {
     status: AutosaveStatus;
@@ -344,4 +227,4 @@ interface RevisionTracker {
  */
 declare function createRevisionTracker(options?: RevisionTrackerOptions): RevisionTracker;
 
-export { type AutosaveController, type AutosaveControllerOptions, type AutosaveRecovery, type AutosaveStatus, type AutosaveStatusInfo, type DirtyFlagSource, type IdbFactoryLike, type IndexedDbAdapterOptions, InjectedStorageError, type LocalStorageAdapterOptions, type MemoryStorage, type OpfsAdapterOptions, type OpfsDirectoryLike, type OpfsFileLike, type RecoveryAction, type RecoveryMeta, type RecoveryPolicy, type RecoveryPolicyOptions, type RecoveryTickOptions, type RevisionChangeSource, type RevisionTracker, type RevisionTrackerOptions, type StorageAdapter, type StorageAdapterOptions, type StorageFailureMode, type StorageOperation, StorageUnavailableError, type WebStorageLike, createAutosaveController, createIndexedDbAdapter, createLocalStorageAdapter, createMemoryStorage, createOpfsAdapter, createRecoveryPolicy, createRevisionTracker, exponentialBackoff, formatRecoveryMessage, isIndexedDbAvailable, isLocalStorageAvailable, isOpfsAvailable, recoveryMetaKey, withStorageFailures };
+export { type AutosaveController, type AutosaveControllerOptions, type AutosaveRecovery, type AutosaveStatus, type AutosaveStatusInfo, type DirtyFlagSource, type RecoveryAction, type RecoveryMeta, type RecoveryPolicy, type RecoveryPolicyOptions, type RecoveryTickOptions, type RevisionChangeSource, type RevisionTracker, type RevisionTrackerOptions, StorageAdapter, createAutosaveController, createRecoveryPolicy, createRevisionTracker, exponentialBackoff, formatRecoveryMessage, recoveryMetaKey };

package/dist/{registry-GJI4gToU.d.cts → registry-CEgwXED1.d.cts}

@@ -35,6 +35,11 @@ interface ImportContext {
      * exports) can import nested files with the same adapters.
      */
     registry?: ImportAdapterRegistry;
+    /**
+     * Per-import options for this adapter: `ImportFileOptions.adapterOptions[adapter.id]`.
+     * Adapters document what they accept (e.g. the PDF adapter's `{ structure: false }`).
+     */
+    options?: unknown;
 }
 interface ImportAdapter<TResult = unknown> {
     /** Unique id, e.g. `markdown`, `html`, `csv`. */
@@ -65,6 +70,11 @@ interface ImportFileOptions {
     fileName?: string;
     /** Overrides the input's own `type`. */
     mimeType?: string;
+    /**
+     * Options for individual adapters, keyed by adapter id; the matching entry
+     * reaches the adapter as `context.options`. Example: `{ pdf: { structure: false } }`.
+     */
+    adapterOptions?: Record<string, unknown>;
 }
 interface ImportOutcome<TResult = unknown> {
     adapterId: string;
@@ -96,6 +106,7 @@ declare function createImportContext(input: ImportInput, details: {
     mimeType?: string;
     target: ImportTarget;
     registry?: ImportAdapterRegistry;
+    options?: unknown;
 }): ImportContext;
 /**
  * A set of import adapters with type matching. Use the default registry via
@@ -136,4 +147,4 @@ declare class ImportAdapterRegistry {
     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 };
+export { type FileLike as F, ImportAdapterRegistry as I, type RegisterImportAdapterOptions as R, type ImportOutcome as a, type ImportAdapter as b, type FindImportAdapterQuery 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-GJI4gToU.d.ts → registry-CEgwXED1.d.ts}

@@ -35,6 +35,11 @@ interface ImportContext {
      * exports) can import nested files with the same adapters.
      */
     registry?: ImportAdapterRegistry;
+    /**
+     * Per-import options for this adapter: `ImportFileOptions.adapterOptions[adapter.id]`.
+     * Adapters document what they accept (e.g. the PDF adapter's `{ structure: false }`).
+     */
+    options?: unknown;
 }
 interface ImportAdapter<TResult = unknown> {
     /** Unique id, e.g. `markdown`, `html`, `csv`. */
@@ -65,6 +70,11 @@ interface ImportFileOptions {
     fileName?: string;
     /** Overrides the input's own `type`. */
     mimeType?: string;
+    /**
+     * Options for individual adapters, keyed by adapter id; the matching entry
+     * reaches the adapter as `context.options`. Example: `{ pdf: { structure: false } }`.
+     */
+    adapterOptions?: Record<string, unknown>;
 }
 interface ImportOutcome<TResult = unknown> {
     adapterId: string;
@@ -96,6 +106,7 @@ declare function createImportContext(input: ImportInput, details: {
     mimeType?: string;
     target: ImportTarget;
     registry?: ImportAdapterRegistry;
+    options?: unknown;
 }): ImportContext;
 /**
  * A set of import adapters with type matching. Use the default registry via
@@ -136,4 +147,4 @@ declare class ImportAdapterRegistry {
     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 };
+export { type FileLike as F, ImportAdapterRegistry as I, type RegisterImportAdapterOptions as R, type ImportOutcome as a, type ImportAdapter as b, type FindImportAdapterQuery 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

@@ -9,7 +9,7 @@
 
 
 
-var _chunkSML64VJGcjs = require('../chunk-SML64VJG.cjs');
+var _chunkV3CHHWOEcjs = require('../chunk-V3CHHWOE.cjs');
 
 
 
@@ -26,13 +26,14 @@ var _chunkSML64VJGcjs = require('../chunk-SML64VJG.cjs');
 
 
 
+var _chunk7WISYZFOcjs = require('../chunk-7WISYZFO.cjs');
 
-var _chunkXNORY7M6cjs = require('../chunk-XNORY7M6.cjs');
-require('../chunk-D27YFC46.cjs');
 
 
 
 
+var _chunkBVP3TSLHcjs = require('../chunk-BVP3TSLH.cjs');
+require('../chunk-X4N4WUKB.cjs');
 
 
 
@@ -55,5 +56,12 @@ require('../chunk-D27YFC46.cjs');
 
 
 
-exports.MARKDOWN_MENTION_SPLIT_REGEX = _chunkXNORY7M6cjs.MARKDOWN_MENTION_SPLIT_REGEX; exports.MENTION_REGEX = _chunkXNORY7M6cjs.MENTION_REGEX; exports.PIXERATE_DOCUMENT_MIME = _chunkSML64VJGcjs.PIXERATE_DOCUMENT_MIME; exports.escapeHtml = _chunkXNORY7M6cjs.escapeHtml; exports.extractMentions = _chunkXNORY7M6cjs.extractMentions; exports.extractMentionsFromDoc = _chunkXNORY7M6cjs.extractMentionsFromDoc; exports.getClipboardData = _chunkSML64VJGcjs.getClipboardData; exports.getEditorMarkdown = _chunkXNORY7M6cjs.getEditorMarkdown; exports.getEditorText = _chunkXNORY7M6cjs.getEditorText; exports.getSchemaSignature = _chunkSML64VJGcjs.getSchemaSignature; exports.htmlToPlainText = _chunkXNORY7M6cjs.htmlToPlainText; exports.markdownToTipTapHtml = _chunkXNORY7M6cjs.markdownToTipTapHtml; exports.parseMentionSegments = _chunkXNORY7M6cjs.parseMentionSegments; exports.parseRichClipboardPayload = _chunkSML64VJGcjs.parseRichClipboardPayload; exports.plainTextToParagraphHtml = _chunkSML64VJGcjs.plainTextToParagraphHtml; exports.plainTextToSlice = _chunkXNORY7M6cjs.plainTextToSlice; exports.plainTextToTipTapHtml = _chunkXNORY7M6cjs.plainTextToTipTapHtml; exports.preprocessMarkdownFileLinks = _chunkXNORY7M6cjs.preprocessMarkdownFileLinks; exports.preprocessMarkdownMentions = _chunkXNORY7M6cjs.preprocessMarkdownMentions; exports.readRichClipboard = _chunkSML64VJGcjs.readRichClipboard; exports.rtfToPlainText = _chunkSML64VJGcjs.rtfToPlainText; exports.sanitizeHtml = _chunkXNORY7M6cjs.sanitizeHtml; exports.sanitizeImportedHtml = _chunkSML64VJGcjs.sanitizeImportedHtml; exports.serializeRichClipboardPayload = _chunkSML64VJGcjs.serializeRichClipboardPayload; exports.stripMarkdownCode = _chunkXNORY7M6cjs.stripMarkdownCode;
+
+
+
+
+
+
+
+exports.MARKDOWN_MENTION_SPLIT_REGEX = _chunk7WISYZFOcjs.MARKDOWN_MENTION_SPLIT_REGEX; exports.MENTION_REGEX = _chunkBVP3TSLHcjs.MENTION_REGEX; exports.PIXERATE_DOCUMENT_MIME = _chunkV3CHHWOEcjs.PIXERATE_DOCUMENT_MIME; exports.escapeHtml = _chunk7WISYZFOcjs.escapeHtml; exports.extractMentions = _chunk7WISYZFOcjs.extractMentions; exports.extractMentionsFromDoc = _chunk7WISYZFOcjs.extractMentionsFromDoc; exports.findTextMentions = _chunkBVP3TSLHcjs.findTextMentions; exports.formatMentionText = _chunkBVP3TSLHcjs.formatMentionText; exports.getClipboardData = _chunkV3CHHWOEcjs.getClipboardData; exports.getEditorMarkdown = _chunk7WISYZFOcjs.getEditorMarkdown; exports.getEditorText = _chunk7WISYZFOcjs.getEditorText; exports.getSchemaSignature = _chunkV3CHHWOEcjs.getSchemaSignature; exports.htmlToPlainText = _chunk7WISYZFOcjs.htmlToPlainText; exports.markdownToTipTapHtml = _chunk7WISYZFOcjs.markdownToTipTapHtml; exports.parseMentionSegments = _chunk7WISYZFOcjs.parseMentionSegments; exports.parseRichClipboardPayload = _chunkV3CHHWOEcjs.parseRichClipboardPayload; exports.plainTextToParagraphHtml = _chunkV3CHHWOEcjs.plainTextToParagraphHtml; exports.plainTextToSlice = _chunk7WISYZFOcjs.plainTextToSlice; exports.plainTextToTipTapHtml = _chunk7WISYZFOcjs.plainTextToTipTapHtml; exports.preprocessMarkdownFileLinks = _chunk7WISYZFOcjs.preprocessMarkdownFileLinks; exports.preprocessMarkdownMentions = _chunk7WISYZFOcjs.preprocessMarkdownMentions; exports.readRichClipboard = _chunkV3CHHWOEcjs.readRichClipboard; exports.rtfToPlainText = _chunkV3CHHWOEcjs.rtfToPlainText; exports.sanitizeHtml = _chunk7WISYZFOcjs.sanitizeHtml; exports.sanitizeImportedHtml = _chunkV3CHHWOEcjs.sanitizeImportedHtml; exports.serializeRichClipboardPayload = _chunkV3CHHWOEcjs.serializeRichClipboardPayload; exports.setMentionRoleInText = _chunkBVP3TSLHcjs.setMentionRoleInText; exports.stripMarkdownCode = _chunk7WISYZFOcjs.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,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,iCAA8B;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"}
+{"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;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;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;AACA;AACA;AACA;AACF,u4DAAC","file":"/home/runner/work/editor/editor/packages/core/dist/serializers/index.cjs"}

package/dist/serializers/index.d.cts

@@ -1,5 +1,7 @@
 import { Schema, Slice } from '@tiptap/pm/model';
-import { n as TrackedChangesView, a as MentionEntity } from '../track-changes-BK5sVf4_.cjs';
+import { r as TrackedChangesView, d as MentionEntity } from '../track-changes-D_VAPELi.cjs';
+import { a as MentionRoleSyntax } from '../mention-text-CDnCFd3c.cjs';
+export { M as MENTION_REGEX, T as TextMention, f as findTextMentions, b as formatMentionText, s as setMentionRoleInText } from '../mention-text-CDnCFd3c.cjs';
 import '@tiptap/core';
 import '@tiptap/extension-mention';
 import '@tiptap/suggestion';
@@ -45,6 +47,8 @@ interface ExtractedMention {
     id: string;
     label: string;
     type?: string;
+    /** Asset role (`data-role`), when set. */
+    role?: string;
     avatarUrl?: string;
     color?: string;
     [key: string]: any;
@@ -55,14 +59,6 @@ interface ExtractedMention {
  */
 declare function extractMentionsFromDoc(docOrEditor: any): ExtractedMention[];
 
-/**
- * Canonical regex pattern for matching @mentions in plain text or markdown.
- * Supports:
- * - Standard unquoted handles: @username, @user.name, @team_alpha, @sa-1
- * - Quoted handles: @"John Doe", "Jane Doe"
- * Unquoted handles exclude trailing punctuation (e.g. @violet. matches "violet" without the dot).
- */
-declare const MENTION_REGEX: RegExp;
 /**
  * Split regex identifying markdown code blocks, inline code, URLs, and existing HTML tags.
  * Used by preprocessMarkdownMentions to ensure non-mention regions remain completely untouched.
@@ -72,6 +68,19 @@ interface MentionSegment {
     type: "text" | "mention";
     value: string;
     handle?: string;
+    /** Role written after the handle (`@fox:style`), when role syntax is enabled. */
+    role?: string;
+}
+/** A mention with its role (asset mentions: `@fox:style`, or `data-role` on a mention node). */
+interface MentionDetail {
+    handle: string;
+    role?: string;
+}
+interface ExtractMentionsOptions {
+    /** Return `{ handle, role }` objects instead of handles. */
+    details?: boolean;
+    /** Read `@handle:role` suffixes in text (see {@link MentionRoleSyntax}). Mention nodes' `data-role` is always read in `details` mode. */
+    roles?: MentionRoleSyntax;
 }
 interface PreprocessMarkdownMentionsOptions {
     /**
@@ -87,6 +96,11 @@ interface PreprocessMarkdownMentionsOptions {
      * Custom resolver callback to derive entity metadata for unmatched handles.
      */
     resolveMention?: (handle: string) => Partial<MentionEntity> | null | undefined;
+    /**
+     * Read `@handle:role` and emit the role as `data-role` (the `:role` text is
+     * consumed). Off by default. See {@link MentionRoleSyntax}.
+     */
+    roles?: MentionRoleSyntax;
 }
 /**
  * Strips code blocks and inline code from markdown or HTML content:
@@ -99,13 +113,26 @@ declare function stripMarkdownCode(content: string): string;
 /**
  * Extracts unique mention handles from a text, markdown, or HTML string,
  * ignoring trailing punctuation, code blocks, URLs, and pre-existing HTML mention attributes.
+ *
+ * With `{ details: true }` it returns `{ handle, role }` objects, unique per
+ * handle and role: roles come from mention nodes' `data-role` and, when
+ * `roles` is set, from `@handle:role` text. Without options the result is
+ * unchanged.
  */
-declare function extractMentions(content: string): string[];
+declare function extractMentions(content: string, options?: ExtractMentionsOptions & {
+    details?: false;
+}): string[];
+declare function extractMentions(content: string, options: ExtractMentionsOptions & {
+    details: true;
+}): MentionDetail[];
+declare function extractMentions(content: string, options?: ExtractMentionsOptions): string[] | MentionDetail[];
 /**
  * Segments a text string into plain text parts and mention tokens.
  * Correctly leaves trailing punctuation (like ".") as part of the following text segment.
  */
-declare function parseMentionSegments(content: string): MentionSegment[];
+declare function parseMentionSegments(content: string, options?: {
+    roles?: MentionRoleSyntax;
+}): MentionSegment[];
 /**
  * Preprocesses markdown text by turning raw @mention handles into TipTap-compatible
  * mention HTML spans (<span class="pixerate-mention-node" data-type="mention" ...>),
@@ -258,4 +285,4 @@ declare function getClipboardData(event: unknown): ClipboardDataLike | null;
  */
 declare function readRichClipboard(event: unknown, schema: Schema, mimeType?: string): Slice | null;
 
-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 };
+export { type ClipboardDataLike, type ExtractMentionsOptions, type ExtractedMention, MARKDOWN_MENTION_SPLIT_REGEX, type MarkdownToHtmlOptions, type MentionDetail, MentionRoleSyntax, 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 };

package/dist/serializers/index.d.ts

@@ -1,5 +1,7 @@
 import { Schema, Slice } from '@tiptap/pm/model';
-import { n as TrackedChangesView, a as MentionEntity } from '../track-changes-CDjCrwKe.js';
+import { r as TrackedChangesView, d as MentionEntity } from '../track-changes-Db_fGEvx.js';
+import { a as MentionRoleSyntax } from '../mention-text-CDnCFd3c.js';
+export { M as MENTION_REGEX, T as TextMention, f as findTextMentions, b as formatMentionText, s as setMentionRoleInText } from '../mention-text-CDnCFd3c.js';
 import '@tiptap/core';
 import '@tiptap/extension-mention';
 import '@tiptap/suggestion';
@@ -45,6 +47,8 @@ interface ExtractedMention {
     id: string;
     label: string;
     type?: string;
+    /** Asset role (`data-role`), when set. */
+    role?: string;
     avatarUrl?: string;
     color?: string;
     [key: string]: any;
@@ -55,14 +59,6 @@ interface ExtractedMention {
  */
 declare function extractMentionsFromDoc(docOrEditor: any): ExtractedMention[];
 
-/**
- * Canonical regex pattern for matching @mentions in plain text or markdown.
- * Supports:
- * - Standard unquoted handles: @username, @user.name, @team_alpha, @sa-1
- * - Quoted handles: @"John Doe", "Jane Doe"
- * Unquoted handles exclude trailing punctuation (e.g. @violet. matches "violet" without the dot).
- */
-declare const MENTION_REGEX: RegExp;
 /**
  * Split regex identifying markdown code blocks, inline code, URLs, and existing HTML tags.
  * Used by preprocessMarkdownMentions to ensure non-mention regions remain completely untouched.
@@ -72,6 +68,19 @@ interface MentionSegment {
     type: "text" | "mention";
     value: string;
     handle?: string;
+    /** Role written after the handle (`@fox:style`), when role syntax is enabled. */
+    role?: string;
+}
+/** A mention with its role (asset mentions: `@fox:style`, or `data-role` on a mention node). */
+interface MentionDetail {
+    handle: string;
+    role?: string;
+}
+interface ExtractMentionsOptions {
+    /** Return `{ handle, role }` objects instead of handles. */
+    details?: boolean;
+    /** Read `@handle:role` suffixes in text (see {@link MentionRoleSyntax}). Mention nodes' `data-role` is always read in `details` mode. */
+    roles?: MentionRoleSyntax;
 }
 interface PreprocessMarkdownMentionsOptions {
     /**
@@ -87,6 +96,11 @@ interface PreprocessMarkdownMentionsOptions {
      * Custom resolver callback to derive entity metadata for unmatched handles.
      */
     resolveMention?: (handle: string) => Partial<MentionEntity> | null | undefined;
+    /**
+     * Read `@handle:role` and emit the role as `data-role` (the `:role` text is
+     * consumed). Off by default. See {@link MentionRoleSyntax}.
+     */
+    roles?: MentionRoleSyntax;
 }
 /**
  * Strips code blocks and inline code from markdown or HTML content:
@@ -99,13 +113,26 @@ declare function stripMarkdownCode(content: string): string;
 /**
  * Extracts unique mention handles from a text, markdown, or HTML string,
  * ignoring trailing punctuation, code blocks, URLs, and pre-existing HTML mention attributes.
+ *
+ * With `{ details: true }` it returns `{ handle, role }` objects, unique per
+ * handle and role: roles come from mention nodes' `data-role` and, when
+ * `roles` is set, from `@handle:role` text. Without options the result is
+ * unchanged.
  */
-declare function extractMentions(content: string): string[];
+declare function extractMentions(content: string, options?: ExtractMentionsOptions & {
+    details?: false;
+}): string[];
+declare function extractMentions(content: string, options: ExtractMentionsOptions & {
+    details: true;
+}): MentionDetail[];
+declare function extractMentions(content: string, options?: ExtractMentionsOptions): string[] | MentionDetail[];
 /**
  * Segments a text string into plain text parts and mention tokens.
  * Correctly leaves trailing punctuation (like ".") as part of the following text segment.
  */
-declare function parseMentionSegments(content: string): MentionSegment[];
+declare function parseMentionSegments(content: string, options?: {
+    roles?: MentionRoleSyntax;
+}): MentionSegment[];
 /**
  * Preprocesses markdown text by turning raw @mention handles into TipTap-compatible
  * mention HTML spans (<span class="pixerate-mention-node" data-type="mention" ...>),
@@ -258,4 +285,4 @@ declare function getClipboardData(event: unknown): ClipboardDataLike | null;
  */
 declare function readRichClipboard(event: unknown, schema: Schema, mimeType?: string): Slice | null;
 
-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 };
+export { type ClipboardDataLike, type ExtractMentionsOptions, type ExtractedMention, MARKDOWN_MENTION_SPLIT_REGEX, type MarkdownToHtmlOptions, type MentionDetail, MentionRoleSyntax, 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 };

package/dist/serializers/index.js

@@ -9,10 +9,9 @@ import {
   rtfToPlainText,
   sanitizeImportedHtml,
   serializeRichClipboardPayload
-} from "../chunk-3LV6RRPH.js";
+} from "../chunk-QGYDWPRM.js";
 import {
   MARKDOWN_MENTION_SPLIT_REGEX,
-  MENTION_REGEX,
   escapeHtml,
   extractMentions,
   extractMentionsFromDoc,
@@ -27,8 +26,14 @@ import {
   preprocessMarkdownMentions,
   sanitizeHtml,
   stripMarkdownCode
-} from "../chunk-PGNZKFQS.js";
-import "../chunk-5S3Z4PPF.js";
+} from "../chunk-ECCCYKGL.js";
+import {
+  MENTION_REGEX,
+  findTextMentions,
+  formatMentionText,
+  setMentionRoleInText
+} from "../chunk-O5RYH2PG.js";
+import "../chunk-UAKDG62Z.js";
 export {
   MARKDOWN_MENTION_SPLIT_REGEX,
   MENTION_REGEX,
@@ -36,6 +41,8 @@ export {
   escapeHtml,
   extractMentions,
   extractMentionsFromDoc,
+  findTextMentions,
+  formatMentionText,
   getClipboardData,
   getEditorMarkdown,
   getEditorText,
@@ -54,6 +61,7 @@ export {
   sanitizeHtml,
   sanitizeImportedHtml,
   serializeRichClipboardPayload,
+  setMentionRoleInText,
   stripMarkdownCode
 };
 //# sourceMappingURL=index.js.map