Add ProseMirror comments docs

Author: yoen-velt

api-reference/sdk/api/api-methods.mdx

@@ -526,6 +526,45 @@ Returns a DraftJS `ContentState` with Velt comment entities removed.
 - React Hook: `n/a`
 - [Full Documentation →](/async-collaboration/comments/setup/draftjs#exportcontentstatewithoutcomments)
 
+### ProseMirror
+
+#### VeltCommentsPlugin()
+Creates the ProseMirror plugin that powers Velt comments. Add it to the editor state's `plugins` array.
+- Params: `config?:` [VeltCommentsPluginConfig](/api-reference/sdk/models/data-models#veltcommentspluginconfig-1)
+- Returns: ProseMirror `Plugin`
+- React Hook: `n/a`
+- [Full Documentation →](/async-collaboration/comments/setup/prosemirror#veltcommentsplugin)
+
+#### addComment()
+Creates a comment annotation for the currently selected text in the ProseMirror editor.
+- Signature: `async (request:` [AddCommentRequest](/api-reference/sdk/models/data-models#addcommentrequest-8)`) => Promise<void>`
+- Params: `request:` [AddCommentRequest](/api-reference/sdk/models/data-models#addcommentrequest-8)
+- Returns: `Promise<void>`
+- React Hook: `n/a`
+- [Full Documentation →](/async-collaboration/comments/setup/prosemirror#addcomment)
+
+#### renderComments()
+Renders and highlights comment annotations in the ProseMirror editor.
+- Signature: `(request:` [RenderCommentsRequest](/api-reference/sdk/models/data-models#rendercommentsrequest-8)`) => void`
+- Params: `request:` [RenderCommentsRequest](/api-reference/sdk/models/data-models#rendercommentsrequest-8)
+- Returns: `void`
+- React Hook: `n/a`
+- [Full Documentation →](/async-collaboration/comments/setup/prosemirror#rendercomments)
+
+#### isVeltAvailable()
+Checks whether the Velt SDK is loaded on `window.Velt`.
+- Params: none
+- Returns: `boolean`
+- React Hook: `n/a`
+- [Full Documentation →](/async-collaboration/comments/setup/prosemirror#isveltavailable)
+
+#### veltCommentsPluginKey
+The ProseMirror `PluginKey` used by the package. Exported for advanced plugin state inspection.
+- Params: none
+- Returns: `PluginKey<VeltPluginState>`
+- React Hook: `n/a`
+- [Full Documentation →](/async-collaboration/comments/setup/prosemirror#veltcommentspluginkey)
+
 
 ### Messages
 

api-reference/sdk/models/data-models.mdx

@@ -1003,6 +1003,78 @@ Props for the `DraftJSVeltEditor` React wrapper.
 
 For the CommentAnnotation model referenced above, see [CommentAnnotation](#commentannotation).
 
+### ProseMirror
+
+#### AddCommentRequest
+
+---
+
+| Property   | Type                                                 | Required | Description                                          |
+| ---------- | ---------------------------------------------------- | -------- | ---------------------------------------------------- |
+| `view`     | `EditorView`                                         | Yes      | ProseMirror editor view instance.                    |
+| `editorId` | `string`                                             | No       | Optional editor ID used to scope operations.         |
+| `context`  | [`CommentAnnotationContext`](#commentannotationcontext-1) | No  | Optional custom context to attach to the annotation. |
+
+#### RenderCommentsRequest
+
+---
+
+| Property             | Type                  | Required | Description                                  |
+| -------------------- | --------------------- | -------- | -------------------------------------------- |
+| `view`               | `EditorView`          | Yes      | ProseMirror editor view instance.            |
+| `editorId`           | `string`              | No       | Optional editor ID used to scope operations. |
+| `commentAnnotations` | `CommentAnnotation[]` | No       | Annotations to render/highlight.             |
+
+For the CommentAnnotation model referenced above, see [CommentAnnotation](#commentannotation).
+
+#### VeltCommentsPluginConfig
+
+---
+
+Configuration options for the `VeltCommentsPlugin()` function.
+
+| Property           | Type      | Required | Description                                                                       |
+| ------------------ | --------- | -------- | --------------------------------------------------------------------------------- |
+| `editorId`         | `string`  | No       | Unique identifier for this editor instance. Use it for multi-editor scenarios.    |
+| `persistVeltMarks` | `boolean` | No       | Reserved for API parity. ProseMirror highlights are always view-only overlays.    |
+
+#### CommentAnnotationContext
+
+---
+
+Context object for comment annotations. Contains text editor configuration and any additional custom metadata.
+
+| Property           | Type                                      | Required | Description                                                |
+| ------------------ | ----------------------------------------- | -------- | ---------------------------------------------------------- |
+| `textEditorConfig` | [`TextEditorConfig`](#texteditorconfig-2) | No       | Text editor configuration auto-generated by the library.   |
+| `[key: string]`    | `unknown`                                 | No       | Any additional custom properties you want to attach.       |
+
+#### TextEditorConfig
+
+---
+
+Nested in `CommentAnnotationContext`.
+
+| Property     | Type     | Required | Description                                       |
+| ------------ | -------- | -------- | ------------------------------------------------- |
+| `text`       | `string` | Yes      | The selected text content.                        |
+| `occurrence` | `number` | Yes      | The occurrence index of the text in the document. |
+| `editorId`   | `string` | No       | The editor ID associated with this comment.       |
+
+#### SelectionContext
+
+---
+
+Context extracted from the current ProseMirror editor selection.
+
+| Property     | Type     | Required | Description                                                            |
+| ------------ | -------- | -------- | ---------------------------------------------------------------------- |
+| `text`       | `string` | Yes      | Selected text content.                                                 |
+| `from`       | `number` | Yes      | ProseMirror start position of the selection.                           |
+| `to`         | `number` | Yes      | ProseMirror end position of the selection.                             |
+| `occurrence` | `number` | Yes      | 1-based index of `text` among all matches in the document.             |
+| `locationId` | `string` | No       | Optional Velt location id derived from a `data-velt-location-id` ancestor. |
+
 ### Messages
 
 #### ENUMs