Add SpreadJS comments docs

Author: yoen-velt

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

@@ -699,6 +699,38 @@ Renders and updates Velt comment highlights in the Nutrient viewer.
 - [Full Documentation →](/async-collaboration/comments/setup/nutrient#rendercomments)
 
 
+### SpreadJS
+
+<a id="spreadjs-spreadjsveltcomments" />
+
+#### SpreadJSVeltComments
+Creates the Velt Comments extension for a SpreadJS workbook. Configure it, then call `.attach(instance)` to wire it to a workbook instance.
+- Config: [SpreadJSVeltCommentsConfig](/api-reference/sdk/models/data-models#spreadjs-spreadjsveltcommentsconfig)
+- Returns: `SpreadJSVeltComments`
+- React Hook: `n/a`
+- [Full Documentation →](/async-collaboration/comments/setup/spreadjs#spreadjsveltcomments)
+
+<a id="spreadjs-addcomment" />
+
+#### addComment()
+Creates a comment annotation for the currently selected SpreadJS cell or range.
+- Signature: `async (args: AddCommentArgs) => Promise<AddCommentResult | null>`
+- Params: `args:` [AddCommentArgs](/api-reference/sdk/models/data-models#spreadjs-addcommentargs)
+- Returns: `Promise<AddCommentResult | null>`
+- React Hook: `n/a`
+- [Full Documentation →](/async-collaboration/comments/setup/spreadjs#addcomment)
+
+<a id="spreadjs-rendercomments" />
+
+#### renderComments()
+Renders and updates Velt comment highlights in the SpreadJS workbook.
+- Signature: `(args:` [RenderCommentsArgs](/api-reference/sdk/models/data-models#spreadjs-rendercommentsargs)`) => void`
+- Params: `args:` [RenderCommentsArgs](/api-reference/sdk/models/data-models#spreadjs-rendercommentsargs)
+- Returns: `void`
+- React Hook: `n/a`
+- [Full Documentation →](/async-collaboration/comments/setup/spreadjs#rendercomments)
+
+
 ### Messages
 
 #### addComment()

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

@@ -1442,6 +1442,92 @@ Logical anchor stored in `annotation.context.textEditorConfig`. Physical rectang
 | `pageNumber` | `number` | Yes      | 1-based page number where the comment lives.          |
 | `occurrence` | `number` | Yes      | 1-based count of this exact text on the page.         |
 
+### SpreadJS
+
+<a id="spreadjs-addcommentargs" />
+
+#### AddCommentArgs
+
+---
+
+Request interface for the SpreadJS `addComment()` function.
+
+| Property   | Type             | Required | Description                         |
+| ---------- | ---------------- | -------- | ----------------------------------- |
+| `instance` | `SpreadInstance` | Yes      | The SpreadJS workbook instance.     |
+
+<a id="spreadjs-addcommentresult" />
+
+#### AddCommentResult
+
+---
+
+Return shape from SpreadJS `addComment()` when the call succeeds. The function returns `null` when no cell/range is selected or Velt is not loaded.
+
+| Property           | Type                                      | Required | Description                                         |
+| ------------------ | ----------------------------------------- | -------- | --------------------------------------------------- |
+| `veltAnnotationId` | `string`                                  | Yes      | The Velt annotation id assigned by the SDK.         |
+| `textEditorConfig` | [`TextEditorConfig`](#spreadjs-texteditorconfig) | Yes      | The durable logical anchor stored on the annotation. |
+
+<a id="spreadjs-rendercommentsargs" />
+
+#### RenderCommentsArgs
+
+---
+
+Request interface for the SpreadJS `renderComments()` function.
+
+| Property             | Type                                       | Required | Description                       |
+| -------------------- | ------------------------------------------ | -------- | --------------------------------- |
+| `instance`           | `SpreadInstance`                           | Yes      | The SpreadJS workbook instance.   |
+| `commentAnnotations` | `CommentAnnotation[] \| null \| undefined` | Yes      | Annotations to render/highlight.  |
+
+For the CommentAnnotation model referenced above, see [CommentAnnotation](#commentannotation).
+
+<a id="spreadjs-spreadjsveltcommentsconfig" />
+
+#### SpreadJSVeltCommentsConfig
+
+---
+
+Configuration options for `SpreadJSVeltComments.configure()`.
+
+| Property                  | Type      | Required | Description                                                                  |
+| ------------------------- | --------- | -------- | ---------------------------------------------------------------------------- |
+| `editorId`                | `string`  | No       | Unique identifier for this workbook instance. Default: `'spreadjs'`.         |
+| `scrollToSelectedComment` | `boolean` | No       | Activate a selected thread's sheet and scroll its cell into view. Default: `true`. |
+
+<a id="spreadjs-attachedextension" />
+
+#### AttachedExtension
+
+---
+
+Handle returned by `SpreadJSVeltComments.configure(...).attach(instance)`.
+
+| Property | Type         | Required | Description                                                        |
+| -------- | ------------ | -------- | ------------------------------------------------------------------ |
+| `detach` | `() => void` | Yes      | Removes every SpreadJS listener and clears per-instance state.      |
+
+<a id="spreadjs-texteditorconfig" />
+
+#### TextEditorConfig
+
+---
+
+Logical anchor stored in `annotation.context.textEditorConfig`. Physical rectangles are re-derived at render time with `Worksheet.getCellRect`, so pixel coordinates are not persisted.
+
+| Property     | Type     | Required | Description                                           |
+| ------------ | -------- | -------- | ----------------------------------------------------- |
+| `editorId`   | `string` | Yes      | The editor id associated with this comment.           |
+| `documentId` | `string` | No       | Optional host workbook/document id. Velt already scopes per document. |
+| `sheetName`  | `string` | Yes      | Authoritative sheet identity; survives sheet reordering. |
+| `sheetIndex` | `number` | No       | Sheet index hint only; `sheetName` wins on mismatch.  |
+| `row`        | `number` | Yes      | 0-based top-left row of the anchored cell/range.      |
+| `col`        | `number` | Yes      | 0-based top-left column of the anchored cell/range.   |
+| `rowCount`   | `number` | Yes      | Row span; `1` means a single cell.                    |
+| `colCount`   | `number` | Yes      | Column span; `1` means a single cell.                 |
+
 ### Messages
 
 #### ENUMs