🔄 Sync stable → main

packages/esign/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/esign",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "React eSignature component for SuperDoc",
   "type": "module",
   "main": "./dist/index.js",

packages/sdk/langs/node/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.cjs",

packages/sdk/langs/node/platforms/sdk-darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk-darwin-arm64",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "os": [
     "darwin"
   ],

packages/sdk/langs/node/platforms/sdk-darwin-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk-darwin-x64",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "os": [
     "darwin"
   ],

packages/sdk/langs/node/platforms/sdk-linux-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk-linux-arm64",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "os": [
     "linux"
   ],

packages/sdk/langs/node/platforms/sdk-linux-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk-linux-x64",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "os": [
     "linux"
   ],

packages/sdk/langs/node/platforms/sdk-windows-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk-windows-x64",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "os": [
     "win32"
   ],

packages/sdk/langs/python/platforms/superdoc-sdk-cli-darwin-arm64/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "superdoc-sdk-cli-darwin-arm64"
-version = "1.5.1"
+version = "1.6.0"
 description = "SuperDoc CLI binary for macOS ARM64 (Apple Silicon)"
 readme = "README.md"
 requires-python = ">=3.9"

packages/sdk/langs/python/platforms/superdoc-sdk-cli-darwin-x64/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "superdoc-sdk-cli-darwin-x64"
-version = "1.5.1"
+version = "1.6.0"
 description = "SuperDoc CLI binary for macOS x64 (Intel)"
 readme = "README.md"
 requires-python = ">=3.9"

packages/sdk/langs/python/platforms/superdoc-sdk-cli-linux-arm64/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "superdoc-sdk-cli-linux-arm64"
-version = "1.5.1"
+version = "1.6.0"
 description = "SuperDoc CLI binary for Linux ARM64"
 readme = "README.md"
 requires-python = ">=3.9"

packages/sdk/langs/python/platforms/superdoc-sdk-cli-linux-x64/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "superdoc-sdk-cli-linux-x64"
-version = "1.5.1"
+version = "1.6.0"
 description = "SuperDoc CLI binary for Linux x64"
 readme = "README.md"
 requires-python = ">=3.9"

packages/sdk/langs/python/platforms/superdoc-sdk-cli-windows-x64/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "superdoc-sdk-cli-windows-x64"
-version = "1.5.1"
+version = "1.6.0"
 description = "SuperDoc CLI binary for Windows x64"
 readme = "README.md"
 requires-python = ">=3.9"

packages/sdk/langs/python/pyproject.toml

@@ -4,18 +4,18 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "superdoc-sdk"
-version = "1.5.1"
+version = "1.6.0"
 description = "SuperDoc SDK (CLI-backed)"
 readme = "README.md"
 requires-python = ">=3.9"
 license = "AGPL-3.0"
 authors = [{ name = "SuperDoc" }]
 dependencies = [
-  "superdoc-sdk-cli-darwin-arm64==1.5.1; platform_system == 'Darwin' and (platform_machine == 'arm64' or platform_machine == 'aarch64' or platform_machine == 'ARM64')",
-  "superdoc-sdk-cli-darwin-x64==1.5.1; platform_system == 'Darwin' and (platform_machine == 'x86_64' or platform_machine == 'AMD64' or platform_machine == 'amd64')",
-  "superdoc-sdk-cli-linux-x64==1.5.1; platform_system == 'Linux' and (platform_machine == 'x86_64' or platform_machine == 'AMD64' or platform_machine == 'amd64')",
-  "superdoc-sdk-cli-linux-arm64==1.5.1; platform_system == 'Linux' and (platform_machine == 'arm64' or platform_machine == 'aarch64' or platform_machine == 'ARM64')",
-  "superdoc-sdk-cli-windows-x64==1.5.1; platform_system == 'Windows' and (platform_machine == 'x86_64' or platform_machine == 'AMD64' or platform_machine == 'amd64')",
+  "superdoc-sdk-cli-darwin-arm64==1.6.0; platform_system == 'Darwin' and (platform_machine == 'arm64' or platform_machine == 'aarch64' or platform_machine == 'ARM64')",
+  "superdoc-sdk-cli-darwin-x64==1.6.0; platform_system == 'Darwin' and (platform_machine == 'x86_64' or platform_machine == 'AMD64' or platform_machine == 'amd64')",
+  "superdoc-sdk-cli-linux-x64==1.6.0; platform_system == 'Linux' and (platform_machine == 'x86_64' or platform_machine == 'AMD64' or platform_machine == 'amd64')",
+  "superdoc-sdk-cli-linux-arm64==1.6.0; platform_system == 'Linux' and (platform_machine == 'arm64' or platform_machine == 'aarch64' or platform_machine == 'ARM64')",
+  "superdoc-sdk-cli-windows-x64==1.6.0; platform_system == 'Windows' and (platform_machine == 'x86_64' or platform_machine == 'AMD64' or platform_machine == 'amd64')",
 ]
 
 [tool.setuptools]

packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk-workspace",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "private": true,
   "type": "module",
   "scripts": {

packages/sdk/version.json

@@ -1,3 +1,3 @@
 {
-  "sdkVersion": "1.5.1"
+  "sdkVersion": "1.6.0"
 }

packages/superdoc/src/core/types/index.js

@@ -527,7 +527,7 @@
  * @property {Object} [links] Link click popover configuration
  * @property {LinkPopoverResolver} [links.popoverResolver] Custom resolver for the link click popover.
  * @property {ContextMenuConfig} [contextMenu] Context menu module configuration
- * @property {Object} [slashMenu] @deprecated Use contextMenu instead
+ * @property {Object} [slashMenu] Deprecated. Use contextMenu instead.
  * @property {SurfacesModuleConfig} [surfaces] Surface system configuration
  * @property {TrackChangesModuleConfig} [trackChanges] Track changes module configuration
  */
@@ -614,6 +614,29 @@
  * @property {string | null} [sectionType] Header/footer variant (`default`, `first`, `even`, `odd`) when available.
  */
 
+/**
+ * @typedef {Object} SuperDocLayoutEngineOptions
+ * @property {'paginated' | 'semantic'} [flowMode='paginated'] Layout engine flow mode.
+ *   - 'paginated': standard page-first layout (default)
+ *   - 'semantic': continuous semantic flow without visible pagination boundaries
+ * @property {Object} [semanticOptions] Internal-only semantic mode tuning options.
+ *   This shape is intentionally not a stable public API in v1.
+ * @property {Object} [trackedChanges] Deprecated. Use `modules.trackChanges` instead. Optional override for paginated track-changes rendering (e.g., `{ mode: 'original' }` or `{ enabled: false }`).
+ */
+
+/**
+ * @typedef {Object} ViewingVisibilityConfig
+ * @property {boolean} [visible]
+ */
+
+/**
+ * @typedef {Object} SuperDocTelemetryConfig
+ * @property {boolean} enabled
+ * @property {string} [endpoint]
+ * @property {Record<string, unknown>} [metadata]
+ * @property {string} [licenseKey]
+ */
+
 /**
  * @typedef {Object} Config
  * @property {string} [superdocId] The ID of the SuperDoc
@@ -649,13 +672,7 @@
  *     uiDisplayFallbackFont: '"Inter", Arial, sans-serif'
  * @property {boolean} [isDev] Whether the SuperDoc is in development mode
  * @property {boolean} [disablePiniaDevtools=false] Disable Pinia/Vue devtools plugin setup for this SuperDoc instance (useful in non-Vue hosts)
- * @property {Object} [layoutEngineOptions] Layout engine overrides passed through to PresentationEditor (page size, margins, virtualization, zoom, debug label, etc.)
- * @property {'paginated' | 'semantic'} [layoutEngineOptions.flowMode='paginated'] Layout engine flow mode.
- *   - 'paginated': standard page-first layout (default)
- *   - 'semantic': continuous semantic flow without visible pagination boundaries
- * @property {Object} [layoutEngineOptions.semanticOptions] Internal-only semantic mode tuning options.
- *   This shape is intentionally not a stable public API in v1.
- * @property {Object} [layoutEngineOptions.trackedChanges] @deprecated Use `modules.trackChanges` instead. Optional override for paginated track-changes rendering (e.g., `{ mode: 'original' }` or `{ enabled: false }`).
+ * @property {SuperDocLayoutEngineOptions} [layoutEngineOptions] Layout engine overrides passed through to PresentationEditor (page size, margins, virtualization, zoom, debug label, etc.)
  * @property {(editor: Editor) => void} [onEditorBeforeCreate] Callback before an editor is created
  * @property {(editor: Editor) => void} [onEditorCreate] Callback after an editor is created
  * @property {(params: EditorTransactionEvent) => void} [onTransaction] Callback when a transaction is made
@@ -678,8 +695,8 @@
  * @property {boolean} [isInternal] Whether the SuperDoc is internal
  * @property {string} [title] The title of the SuperDoc
  * @property {Object[]} [conversations] The conversations to load
- * @property {{ visible?: boolean }} [comments] Toggle comment visibility when `documentMode` is `viewing` (default: false)
- * @property {{ visible?: boolean }} [trackChanges] @deprecated Use `modules.trackChanges.visible` instead. Toggle tracked-change visibility when `documentMode` is `viewing` (default: false).
+ * @property {ViewingVisibilityConfig} [comments] Toggle comment visibility when `documentMode` is `viewing` (default: false)
+ * @property {ViewingVisibilityConfig} [trackChanges] Deprecated. Use `modules.trackChanges.visible` instead. Toggle tracked-change visibility when `documentMode` is `viewing` (default: false).
  * @property {boolean} [isLocked] Whether the SuperDoc is locked
  * @property {function(File): Promise<string>} [handleImageUpload] The function to handle image uploads
  * @property {User} [lockedBy] The user who locked the SuperDoc
@@ -699,7 +716,7 @@
  *   Default behavior (false) lets the document expand to its natural height.
  * @property {string} [cspNonce] Content Security Policy nonce for dynamically injected styles
  * @property {string} [licenseKey] License key for organization identification
- * @property {{ enabled: boolean, endpoint?: string, metadata?: Record<string, unknown>, licenseKey?: string }} [telemetry] Telemetry configuration
+ * @property {SuperDocTelemetryConfig} [telemetry] Telemetry configuration
  * @property {ProofingConfig} [proofing] Proofing / spellcheck configuration
  */