@richhtmleditor/comments 1.0.0

package/README.md

@@ -0,0 +1,121 @@
+# @richhtmleditor/comments
+
+Review and comments workflow plugin for Rich HTML Editor (enterprise). Anchored highlights, Add Comment modal, hover tooltips, comments panel, @mentions, and export HTML — requires `features.comments` from [`@richhtmleditor/enterprise`](https://www.npmjs.com/package/@richhtmleditor/enterprise), built on [`@richhtmleditor/core`](https://www.npmjs.com/package/@richhtmleditor/core).
+
+**Current release: 1.0.0** — Depends on `@richhtmleditor/core` **^1.0.0**.
+
+**Repository:** [github.com/rajkishorsahu89/richhtmleditor](https://github.com/rajkishorsahu89/richhtmleditor)
+
+**Demo:** [richhtmleditor.vercel.app](https://richhtmleditor.vercel.app/) — [demo](https://richhtmleditor.vercel.app/demo) · [guide](https://richhtmleditor.vercel.app/guide) · [API](https://richhtmleditor.vercel.app/api). Doc Preview joint demo: [doc-preview-app.vercel.app/demo/enterprise](https://doc-preview-app.vercel.app/demo/enterprise)
+
+### What's in 1.0.0
+
+- **`createCommentsPlugin`** — toolbar Comment and Comments panel buttons
+- **Add Comment modal** — compose popover anchored to the current text selection
+- **Anchored highlights** — `<span data-de-comment-id>` markers in document HTML
+- **Hover tooltips** — preview thread excerpt and messages on anchor hover
+- **Comments panel** — thread list with reply, resolve, and reopen
+- **@mentions** — autocomplete in compose box (`mentionUsers` option)
+- **Export HTML** — `buildCommentsExportHtml` and `editor.getCommentsExportHtml()` for publish bundles
+
+> Requires `features.comments: true`. Demo keys: `RHE-ENT-DEMO-2026-FULL` or `RHE-ENT-DEMO-2026-COMMENTS`.
+
+**Keywords:** `richhtmleditor` `comments` `review` `enterprise` `annotations` `wysiwyg`
+
+## Install
+
+```bash
+npm install @richhtmleditor/comments @richhtmleditor/enterprise
+# Requires @richhtmleditor/core (via framework wrapper or direct install).
+```
+
+## Usage
+
+```ts
+import { createEditor } from "@richhtmleditor/core";
+import { createCommentsPlugin } from "@richhtmleditor/comments";
+import { resolveEnterpriseFeatures } from "@richhtmleditor/enterprise/browser";
+
+const gate = resolveEnterpriseFeatures({ token: "RHE-ENT-DEMO-2026-FULL" });
+
+const editor = createEditor({
+  element: host,
+  toolbar: { preset: "full" },
+  features: gate.features,
+  plugins: [
+    createCommentsPlugin({
+      author: "Reviewer",
+      mentionUsers: ["reviewer", "approver", "legal", "publisher"],
+      onChange: (threads) => saveThreads(threads)
+    })
+  ]
+});
+```
+
+Select text in the document, click **Comment** (toolbar or selection chip), and add a comment in the compose popover. Anchors persist in exported HTML as `data-de-comment-id` spans.
+
+## Usage — export with comments
+
+```ts
+import { buildCommentsExportHtml } from "@richhtmleditor/comments";
+
+const commentsHtml = editor.getCommentsExportHtml?.()
+  ?? buildCommentsExportHtml(threads);
+
+const preview = editor.exportForPreview({
+  workflowState: "in_review",
+  commentsHtml
+});
+```
+
+## API
+
+### `createCommentsPlugin(options?)`
+
+| Option | Type | Description |
+| --- | --- | --- |
+| `author` | `string` | Default author name for new messages (default `"Reviewer"`). |
+| `initialThreads` | `CommentThread[]` | Pre-load comment threads. |
+| `onChange` | `(threads: CommentThread[]) => void` | Fired when threads are added, replied, or resolved. |
+| `mentionUsers` | `string[]` | Users for `@mention` autocomplete. |
+
+### `CommentThread`
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `id` | `string` | Thread identifier. |
+| `excerpt` | `string` | Quoted selection text. |
+| `status` | `"open" \| "resolved"` | Thread state. |
+| `anchorId` | `string?` | Links to `data-de-comment-id` in document HTML. |
+| `messages` | `Array<{ id, author, body, createdAt }>` | Thread messages. |
+
+### Toolbar tools registered
+
+| Tool ID | Description |
+| --- | --- |
+| `commentAdd` | Comment on selected text (opens compose popover). |
+| `commentPanel` | Toggle comments side panel. |
+
+### Editor extensions (when plugin attached)
+
+| Method | Description |
+| --- | --- |
+| `getCommentThreads()` | Current thread list. |
+| `getCommentsExportHtml()` | HTML aside for `exportForPreview({ commentsHtml })`. |
+
+### `buildCommentsExportHtml(threads)`
+
+Standalone export helper — returns an HTML fragment for comment threads.
+
+## Related packages
+
+- [`@richhtmleditor/core`](https://www.npmjs.com/package/@richhtmleditor/core) — editor engine and `exportForPreview`.
+- [`@richhtmleditor/enterprise`](https://www.npmjs.com/package/@richhtmleditor/enterprise) — licence gating for `features.comments`.
+- [`@richhtmleditor/workflows`](https://www.npmjs.com/package/@richhtmleditor/workflows) — draft/review/approved states.
+- [`@richhtmleditor/ai`](https://www.npmjs.com/package/@richhtmleditor/ai) — AI authoring plugin.
+- [`@richhtmleditor/angular`](https://www.npmjs.com/package/@richhtmleditor/angular) — Angular wrapper.
+- [`@richhtmleditor/react`](https://www.npmjs.com/package/@richhtmleditor/react) — React wrapper.
+
+## License
+
+[MIT](./LICENSE)

package/dist/anchors.d.ts

@@ -0,0 +1,7 @@
+export declare function wrapRangeAnchor(contentEl: HTMLElement, range: Range, threadId: string): boolean;
+export declare function wrapSelectionAnchor(contentEl: HTMLElement, threadId: string): boolean;
+export declare function setAnchorResolved(contentEl: HTMLElement, threadId: string, resolved: boolean): void;
+export declare function scrollToAnchor(contentEl: HTMLElement, threadId: string): void;
+export declare function readAnchorExcerpt(contentEl: HTMLElement, threadId: string): string;
+export declare function scanAnchorsFromHtml(contentEl: HTMLElement): string[];
+//# sourceMappingURL=anchors.d.ts.map

package/dist/anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../src/anchors.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAwB/F;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMrF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAWnG;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAG7E;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGlF;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,EAAE,CAIpE"}

package/dist/anchors.js

@@ -0,0 +1,60 @@
+const ANCHOR_CLASS = "de-comment-anchor";
+const ANCHOR_ATTR = "data-de-comment-id";
+export function wrapRangeAnchor(contentEl, range, threadId) {
+    if (!contentEl.contains(range.commonAncestorContainer)) {
+        return false;
+    }
+    const span = document.createElement("span");
+    span.className = ANCHOR_CLASS;
+    span.setAttribute(ANCHOR_ATTR, threadId);
+    span.style.background = "rgba(251,191,36,.38)";
+    span.style.borderBottom = "2px solid #f59e0b";
+    span.style.borderRadius = "2px";
+    const working = range.cloneRange();
+    try {
+        working.surroundContents(span);
+    }
+    catch {
+        try {
+            const fragment = working.extractContents();
+            span.appendChild(fragment);
+            working.insertNode(span);
+        }
+        catch {
+            return false;
+        }
+    }
+    contentEl.dispatchEvent(new Event("input", { bubbles: true }));
+    return true;
+}
+export function wrapSelectionAnchor(contentEl, threadId) {
+    const sel = window.getSelection();
+    if (!sel?.rangeCount || sel.isCollapsed) {
+        return false;
+    }
+    return wrapRangeAnchor(contentEl, sel.getRangeAt(0), threadId);
+}
+export function setAnchorResolved(contentEl, threadId, resolved) {
+    const anchor = contentEl.querySelector(`[${ANCHOR_ATTR}="${threadId}"]`);
+    if (!anchor) {
+        return;
+    }
+    const wasResolved = anchor.classList.contains("de-comment-anchor--resolved");
+    if (wasResolved === resolved) {
+        return;
+    }
+    anchor.classList.toggle("de-comment-anchor--resolved", resolved);
+    contentEl.dispatchEvent(new Event("input", { bubbles: true }));
+}
+export function scrollToAnchor(contentEl, threadId) {
+    const anchor = contentEl.querySelector(`[${ANCHOR_ATTR}="${threadId}"]`);
+    anchor?.scrollIntoView({ block: "center", behavior: "smooth" });
+}
+export function readAnchorExcerpt(contentEl, threadId) {
+    const anchor = contentEl.querySelector(`[${ANCHOR_ATTR}="${threadId}"]`);
+    return anchor?.textContent?.trim() ?? "";
+}
+export function scanAnchorsFromHtml(contentEl) {
+    return [...contentEl.querySelectorAll(`[${ANCHOR_ATTR}]`)].map((node) => node.getAttribute(ANCHOR_ATTR) ?? "").filter(Boolean);
+}
+//# sourceMappingURL=anchors.js.map

package/dist/anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../src/anchors.ts"],"names":[],"mappings":"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"}

package/dist/comment-popover.d.ts

@@ -0,0 +1,36 @@
+import type { EditorInstance } from "@richhtmleditor/core";
+import type { CommentThread, CommentsPluginOptions } from "./types.js";
+type SavedSelection = {
+    anchor: {
+        block: number;
+        offset: number;
+        listItem?: number;
+        tableRow?: number;
+        tableCol?: number;
+        sectionPath?: number[];
+        sectionTitle?: boolean;
+        collapsiblePath?: Array<"summary" | number>;
+    };
+    head: SavedSelection["anchor"];
+};
+export type CommentComposePopoverMount = {
+    openAtSelection: () => void;
+    close: () => void;
+    isOpen: () => boolean;
+    destroy: () => void;
+};
+type ComposeStore = {
+    threads: CommentThread[];
+};
+export declare function mountCommentComposePopover(_editor: EditorInstance, host: HTMLElement, contentEl: HTMLElement, store: ComposeStore, pluginOptions: CommentsPluginOptions, helpers: {
+    newId: () => string;
+    notify: () => void;
+    refreshPanel: () => void;
+    openPanel: () => void;
+    captureSelection: () => SavedSelection | null;
+    applyAnchor: (threadId: string, selection: SavedSelection) => boolean;
+    readAnchorExcerpt: (threadId: string) => string;
+}): CommentComposePopoverMount;
+export declare function mountCommentHoverPreview(host: HTMLElement, contentEl: HTMLElement, getThread: (anchorId: string) => CommentThread | undefined): () => void;
+export {};
+//# sourceMappingURL=comment-popover.d.ts.map

package/dist/comment-popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-popover.d.ts","sourceRoot":"","sources":["../src/comment-popover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEvE,KAAK,cAAc,GAAG;IACpB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC;KAC7C,CAAC;IACF,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;CAChC,CAAC;AAUF,MAAM,MAAM,0BAA0B,GAAG;IACvC,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,qBAAqB,EACpC,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,gBAAgB,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IAC9C,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,KAAK,OAAO,CAAC;IACtE,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CACjD,GACA,0BAA0B,CAsJ5B;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,WAAW,EACtB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,GACzD,MAAM,IAAI,CAoIZ"}

package/dist/comment-popover.js

@@ -0,0 +1,267 @@
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+export function mountCommentComposePopover(_editor, host, contentEl, store, pluginOptions, helpers) {
+    let backdrop = null;
+    let savedSelection = null;
+    let savedExcerpt = "";
+    const removeModal = () => {
+        backdrop?.remove();
+        backdrop = null;
+        savedSelection = null;
+        savedExcerpt = "";
+    };
+    const submitComment = (body) => {
+        if (!savedSelection) {
+            return;
+        }
+        const threadId = helpers.newId();
+        const anchored = helpers.applyAnchor(threadId, savedSelection);
+        const excerpt = anchored ? helpers.readAnchorExcerpt(threadId) || savedExcerpt : savedExcerpt;
+        store.threads.unshift({
+            id: threadId,
+            excerpt,
+            anchorId: anchored ? threadId : undefined,
+            status: "open",
+            messages: [
+                {
+                    id: helpers.newId(),
+                    author: pluginOptions.author ?? "Reviewer",
+                    body,
+                    createdAt: new Date().toISOString()
+                }
+            ]
+        });
+        helpers.refreshPanel();
+        helpers.notify();
+        helpers.openPanel();
+        removeModal();
+    };
+    const bindModalEvents = (root) => {
+        root.addEventListener("keydown", (event) => event.stopPropagation());
+        root.addEventListener("beforeinput", (event) => event.stopPropagation());
+        root.addEventListener("input", (event) => event.stopPropagation());
+    };
+    const openAtSelection = () => {
+        const sel = window.getSelection();
+        if (!sel?.rangeCount || sel.isCollapsed || !contentEl.contains(sel.anchorNode)) {
+            return;
+        }
+        const excerpt = sel.toString().trim();
+        const selection = helpers.captureSelection();
+        if (!excerpt || !selection) {
+            return;
+        }
+        removeModal();
+        savedExcerpt = excerpt;
+        savedSelection = selection;
+        backdrop = document.createElement("div");
+        backdrop.className = "de-comment-modal-backdrop";
+        backdrop.setAttribute("role", "presentation");
+        backdrop.innerHTML = `
+      <div class="de-comment-modal" role="dialog" aria-label="Add comment" contenteditable="false">
+        <div class="de-comment-modal__head">
+          <h4 class="de-comment-modal__title">Add Comment</h4>
+          <button type="button" class="de-comment-modal__close" aria-label="Close">×</button>
+        </div>
+        <div class="de-comment-modal__quote">
+          <span class="de-comment-modal__quote-bar" aria-hidden="true"></span>
+          <span class="de-comment-modal__quote-text">${escapeHtml(excerpt)}</span>
+        </div>
+        <label class="de-comment-modal__label">Comment:</label>
+        <textarea class="de-comment-modal__input" placeholder="Type your comment…" rows="4"></textarea>
+        <div class="de-comment-modal__actions">
+          <button type="button" class="de-comment-modal__btn de-comment-modal__btn--submit">Add Comment</button>
+        </div>
+      </div>
+    `;
+        bindModalEvents(backdrop);
+        host.appendChild(backdrop);
+        const modal = backdrop.querySelector(".de-comment-modal");
+        const textarea = backdrop.querySelector(".de-comment-modal__input");
+        const closeBtn = backdrop.querySelector(".de-comment-modal__close");
+        const submitBtn = backdrop.querySelector(".de-comment-modal__btn--submit");
+        modal.addEventListener("mousedown", (event) => {
+            if (!event.target.closest("textarea, button")) {
+                event.preventDefault();
+            }
+        });
+        const close = () => removeModal();
+        closeBtn.addEventListener("click", (event) => {
+            event.stopPropagation();
+            close();
+        });
+        backdrop.addEventListener("click", (event) => {
+            if (event.target === backdrop) {
+                close();
+            }
+        });
+        submitBtn.addEventListener("click", (event) => {
+            event.stopPropagation();
+            const body = textarea.value.trim();
+            if (!body) {
+                textarea.focus();
+                return;
+            }
+            submitComment(body);
+        });
+        textarea.addEventListener("keydown", (event) => {
+            event.stopPropagation();
+            if (event.key === "Escape") {
+                event.preventDefault();
+                close();
+            }
+            if ((event.ctrlKey || event.metaKey) && event.key === "Enter") {
+                event.preventDefault();
+                const body = textarea.value.trim();
+                if (body) {
+                    submitComment(body);
+                }
+            }
+        });
+        requestAnimationFrame(() => textarea.focus());
+    };
+    const onDocKeyDown = (event) => {
+        if (event.key === "Escape" && backdrop) {
+            removeModal();
+        }
+    };
+    document.addEventListener("keydown", onDocKeyDown);
+    return {
+        openAtSelection,
+        close: removeModal,
+        isOpen: () => Boolean(backdrop),
+        destroy: () => {
+            document.removeEventListener("keydown", onDocKeyDown);
+            removeModal();
+        }
+    };
+}
+export function mountCommentHoverPreview(host, contentEl, getThread) {
+    let tip = null;
+    let showTimer = 0;
+    let hideTimer = 0;
+    let activeAnchorId = null;
+    const removeTip = () => {
+        tip?.remove();
+        tip = null;
+        activeAnchorId = null;
+    };
+    const positionTip = (anchor) => {
+        if (!tip) {
+            return;
+        }
+        const rect = anchor.getBoundingClientRect();
+        const hostRect = host.getBoundingClientRect();
+        const width = tip.offsetWidth || 280;
+        let left = rect.left - hostRect.left + host.scrollLeft;
+        let top = rect.bottom - hostRect.top + host.scrollTop + 6;
+        const maxLeft = Math.max(4, host.clientWidth - width - 4);
+        left = Math.max(4, Math.min(left, maxLeft));
+        tip.style.left = `${left}px`;
+        tip.style.top = `${top}px`;
+    };
+    const showTip = (anchor, anchorId) => {
+        const thread = getThread(anchorId);
+        const highlighted = anchor.textContent?.trim() || thread?.excerpt || "";
+        if (!highlighted && !thread?.messages.length) {
+            return;
+        }
+        removeTip();
+        activeAnchorId = anchorId;
+        tip = document.createElement("div");
+        tip.className = `de-comment-hover-tip${thread?.status === "resolved" ? " de-comment-hover-tip--resolved" : ""}`;
+        tip.setAttribute("role", "tooltip");
+        const title = document.createElement("p");
+        title.className = "de-comment-hover-tip__title";
+        title.textContent = thread?.status === "resolved" ? "Resolved" : "Open";
+        tip.appendChild(title);
+        if (highlighted) {
+            const excerpt = document.createElement("p");
+            excerpt.className = "de-comment-hover-tip__highlight";
+            excerpt.textContent = highlighted;
+            tip.appendChild(excerpt);
+        }
+        const messages = thread?.messages ?? [];
+        for (const msg of messages.slice(-3)) {
+            const line = document.createElement("p");
+            line.className = "de-comment-hover-tip__msg";
+            line.innerHTML = `<strong>${escapeHtml(msg.author)}:</strong> ${escapeHtml(msg.body)}`;
+            tip.appendChild(line);
+        }
+        if (getComputedStyle(host).position === "static") {
+            host.style.position = "relative";
+        }
+        tip.addEventListener("mouseenter", () => window.clearTimeout(hideTimer));
+        tip.addEventListener("mouseleave", () => {
+            hideTimer = window.setTimeout(removeTip, 120);
+        });
+        host.appendChild(tip);
+        positionTip(anchor);
+    };
+    const onPointerOver = (event) => {
+        const anchor = event.target?.closest("[data-de-comment-id]");
+        if (!anchor || !contentEl.contains(anchor)) {
+            return;
+        }
+        const anchorId = anchor.getAttribute("data-de-comment-id");
+        if (!anchorId) {
+            return;
+        }
+        window.clearTimeout(hideTimer);
+        window.clearTimeout(showTimer);
+        showTimer = window.setTimeout(() => {
+            if (activeAnchorId !== anchorId) {
+                showTip(anchor, anchorId);
+            }
+            else {
+                positionTip(anchor);
+            }
+        }, 100);
+    };
+    const onPointerOut = (event) => {
+        const related = event.relatedTarget;
+        if (tip?.contains(related)) {
+            return;
+        }
+        const anchor = event.target?.closest("[data-de-comment-id]");
+        if (!anchor) {
+            return;
+        }
+        if (related && anchor.contains(related)) {
+            return;
+        }
+        window.clearTimeout(showTimer);
+        hideTimer = window.setTimeout(removeTip, 120);
+    };
+    const onScroll = () => {
+        if (!tip || !activeAnchorId) {
+            return;
+        }
+        const anchor = contentEl.querySelector(`[data-de-comment-id="${activeAnchorId}"]`);
+        if (anchor) {
+            positionTip(anchor);
+        }
+        else {
+            removeTip();
+        }
+    };
+    contentEl.addEventListener("pointerover", onPointerOver);
+    contentEl.addEventListener("pointerout", onPointerOut);
+    host.addEventListener("scroll", onScroll, { passive: true });
+    contentEl.addEventListener("scroll", onScroll, { passive: true });
+    return () => {
+        window.clearTimeout(showTimer);
+        window.clearTimeout(hideTimer);
+        contentEl.removeEventListener("pointerover", onPointerOver);
+        contentEl.removeEventListener("pointerout", onPointerOut);
+        host.removeEventListener("scroll", onScroll);
+        contentEl.removeEventListener("scroll", onScroll);
+        removeTip();
+    };
+}
+//# sourceMappingURL=comment-popover.js.map

package/dist/comment-popover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-popover.js","sourceRoot":"","sources":["../src/comment-popover.ts"],"names":[],"mappings":"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"}

package/dist/export.d.ts

@@ -0,0 +1,5 @@
+import type { CommentThread } from "./types.js";
+export type CommentExportThread = Pick<CommentThread, "id" | "excerpt" | "status" | "anchorId" | "messages">;
+/** Build a comments aside for preview / print / DOCX export HTML. */
+export declare function buildCommentsExportHtml(threads: CommentExportThread[]): string;
+//# sourceMappingURL=export.d.ts.map

package/dist/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC;AAU7G,qEAAqE;AACrE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAyB9E"}

package/dist/export.js

@@ -0,0 +1,30 @@
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/** Build a comments aside for preview / print / DOCX export HTML. */
+export function buildCommentsExportHtml(threads) {
+    if (!threads.length) {
+        return "";
+    }
+    const items = threads
+        .map((thread) => {
+        const resolved = thread.status === "resolved";
+        const excerpt = thread.excerpt
+            ? `<p class="de-comments-export__excerpt">"${escapeHtml(thread.excerpt)}"</p>`
+            : thread.anchorId
+                ? `<p class="de-comments-export__excerpt">(anchored selection)</p>`
+                : "";
+        const messages = thread.messages
+            .map((msg) => `<p class="de-comments-export__msg"><strong>${escapeHtml(msg.author)}:</strong> ${escapeHtml(msg.body)}</p>`)
+            .join("");
+        const status = `<p class="de-comments-export__status">${resolved ? "Resolved" : "Open"}</p>`;
+        return `<article class="de-comments-export__thread${resolved ? " de-comments-export__thread--resolved" : ""}"${thread.anchorId ? ` data-comment-id="${escapeHtml(thread.anchorId)}"` : ""}>${excerpt}${messages}${status}</article>`;
+    })
+        .join("");
+    return `<aside class="de-comments-export" aria-label="Document comments"><h2 class="de-comments-export__title">Comments</h2>${items}</aside>`;
+}
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAIA,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI;SACR,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,uBAAuB,CAAC,OAA8B;IACpE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAG,OAAO;SAClB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO;YAC5B,CAAC,CAAC,2CAA2C,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO;YAC9E,CAAC,CAAC,MAAM,CAAC,QAAQ;gBACf,CAAC,CAAC,iEAAiE;gBACnE,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ;aAC7B,GAAG,CACF,CAAC,GAAG,EAAE,EAAE,CACN,8CAA8C,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAC/G;aACA,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,MAAM,MAAM,GAAG,yCAAyC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC;QAC7F,OAAO,6CAA6C,QAAQ,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,EAAE,IACzG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,qBAAqB,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAC1E,IAAI,OAAO,GAAG,QAAQ,GAAG,MAAM,YAAY,CAAC;IAC9C,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,uHAAuH,KAAK,UAAU,CAAC;AAChJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { EditorPlugin } from "@richhtmleditor/core";
+import type { CommentsPluginOptions } from "./types.js";
+export type { CommentStatus, CommentThread, CommentsPluginOptions } from "./types.js";
+/**
+ * Enterprise review/comments workflow — requires `features.comments`.
+ * Wraps the current selection in a document anchor and links threads to
+ * <span data-de-comment-id> markers in exported HTML.
+ */
+export declare function createCommentsPlugin(options?: CommentsPluginOptions): EditorPlugin;
+export { buildCommentsExportHtml } from "./export.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAyB,MAAM,sBAAsB,CAAC;AAWhG,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEvE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAkWtF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,YAAY,CAwItF;AAED,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}