Add SuperDoc comments docs

Author: yoen-velt

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

@@ -628,6 +628,32 @@ Checks whether the Velt SDK is loaded on `window.Velt`.
 - [Full Documentation →](/async-collaboration/comments/setup/monaco#isveltavailable)
 
 
+### SuperDoc
+
+#### SuperDocVeltComments
+Creates the Velt Comments extension for a SuperDoc editor. Configure it, then call `.attach(instance)` to wire it to an editor.
+- Config: [SuperDocVeltCommentsConfig](/api-reference/sdk/models/data-models#superdocveltcommentsconfig)
+- Returns: `SuperDocVeltComments`
+- React Hook: `n/a`
+- [Full Documentation →](/async-collaboration/comments/setup/superdoc#superdocveltcomments)
+
+#### addComment()
+Creates a comment annotation for the currently selected text in the SuperDoc editor.
+- Signature: `async (args: AddCommentArgs) => Promise<AddCommentResult | null>`
+- Params: `args:` [AddCommentArgs](/api-reference/sdk/models/data-models#addcommentargs-1)
+- Returns: `Promise<AddCommentResult | null>`
+- React Hook: `n/a`
+- [Full Documentation →](/async-collaboration/comments/setup/superdoc#addcomment)
+
+#### renderComments()
+Renders and updates Velt comment highlights in the SuperDoc editor.
+- Signature: `(args:` [RenderCommentsArgs](/api-reference/sdk/models/data-models#rendercommentsargs-1)`) => void`
+- Params: `args:` [RenderCommentsArgs](/api-reference/sdk/models/data-models#rendercommentsargs-1)
+- Returns: `void`
+- React Hook: `n/a`
+- [Full Documentation →](/async-collaboration/comments/setup/superdoc#rendercomments)
+
+
 ### Messages
 
 #### addComment()

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

@@ -1251,6 +1251,76 @@ Resolved Monaco anchor data used while synchronizing Velt comment annotations to
 | `multiThreadAnnotationId` | `string`       | No       | Velt annotation ID associated with the anchor.     |
 | `isSelected`              | `boolean`      | Yes      | Whether the anchor is currently selected in Velt. |
 
+### SuperDoc
+
+#### AddCommentArgs
+
+---
+
+Request interface for the SuperDoc `addComment()` function.
+
+| Property   | Type               | Required | Description                         |
+| ---------- | ------------------ | -------- | ----------------------------------- |
+| `instance` | `SuperDocInstance` | Yes      | The SuperDoc editor instance.       |
+
+#### AddCommentResult
+
+---
+
+Return shape from SuperDoc `addComment()` when the call succeeds. The function returns `null` when no text is selected or Velt is not loaded.
+
+| Property           | Type                                      | Required | Description                                         |
+| ------------------ | ----------------------------------------- | -------- | --------------------------------------------------- |
+| `veltAnnotationId` | `string`                                  | Yes      | The Velt annotation id assigned by the SDK.         |
+| `textEditorConfig` | [`TextEditorConfig`](#texteditorconfig-5) | Yes      | The durable logical anchor stored on the annotation. |
+
+#### RenderCommentsArgs
+
+---
+
+Request interface for the SuperDoc `renderComments()` function.
+
+| Property             | Type                                       | Required | Description                       |
+| -------------------- | ------------------------------------------ | -------- | --------------------------------- |
+| `instance`           | `SuperDocInstance`                         | Yes      | The SuperDoc editor instance.     |
+| `commentAnnotations` | `CommentAnnotation[] \| null \| undefined` | Yes      | Annotations to render/highlight.  |
+
+For the CommentAnnotation model referenced above, see [CommentAnnotation](#commentannotation).
+
+#### SuperDocVeltCommentsConfig
+
+---
+
+Configuration options for `SuperDocVeltComments.configure()`.
+
+| Property                  | Type      | Required | Description                                                                |
+| ------------------------- | --------- | -------- | -------------------------------------------------------------------------- |
+| `editorId`                | `string`  | No       | Unique identifier for this editor instance. Default: `'superdoc'`.         |
+| `scrollToSelectedComment` | `boolean` | No       | Scroll a selected thread's text into view. Default: `true`.                |
+
+#### AttachedExtension
+
+---
+
+Handle returned by `SuperDocVeltComments.configure(...).attach(instance)`.
+
+| Property | Type         | Required | Description                                                        |
+| -------- | ------------ | -------- | ------------------------------------------------------------------ |
+| `detach` | `() => void` | Yes      | Removes every SuperDoc listener and clears per-instance state.      |
+
+#### TextEditorConfig
+
+---
+
+Logical anchor stored in `annotation.context.textEditorConfig`. Physical rectangles are re-derived at render time from the live document, so pixel coordinates and raw editor positions are not persisted.
+
+| Property     | Type     | Required | Description                                              |
+| ------------ | -------- | -------- | -------------------------------------------------------- |
+| `editorId`   | `string` | Yes      | The editor id associated with this comment.              |
+| `documentId` | `string` | No       | Optional host document id. Velt already scopes per doc.  |
+| `text`       | `string` | Yes      | The canonicalized selected text.                         |
+| `occurrence` | `number` | Yes      | 1-based count of this exact text in the document.        |
+
 ### Messages
 
 #### ENUMs