chore: merge stable into main (#2778)

superdoc-bot[bot] · github-actions[bot] · web-flow · commit 87cba73eb89b · 2026-04-10T22:28:33.000Z
Co-authored-by: github-actions[bot] &lt;github-actions[bot]@users.noreply.github.com&gt;
diff --git a/apps/cli/platforms/cli-darwin-arm64/package.json b/apps/cli/platforms/cli-darwin-arm64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli-darwin-arm64",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "os": [
     "darwin"
   ],
diff --git a/apps/cli/platforms/cli-darwin-x64/package.json b/apps/cli/platforms/cli-darwin-x64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli-darwin-x64",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "os": [
     "darwin"
   ],
diff --git a/apps/cli/platforms/cli-linux-arm64/package.json b/apps/cli/platforms/cli-linux-arm64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli-linux-arm64",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "os": [
     "linux"
   ],
diff --git a/apps/cli/platforms/cli-linux-x64/package.json b/apps/cli/platforms/cli-linux-x64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli-linux-x64",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "os": [
     "linux"
   ],
diff --git a/apps/cli/platforms/cli-windows-x64/package.json b/apps/cli/platforms/cli-windows-x64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli-windows-x64",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "os": [
     "win32"
   ],
diff --git a/apps/docs/solutions/template-builder/api-reference.mdx b/apps/docs/solutions/template-builder/api-reference.mdx
@@ -21,7 +21,7 @@ None - the component works with zero configuration.
       Document to load. Can be a URL, File object, or Blob
     </ParamField>
     <ParamField path="mode" type="'editing' | 'viewing'" default="'editing'">
-      Document interaction mode
+      Document interaction mode. Reactive — changing this at runtime switches modes without recreating the editor.
     </ParamField>
   </Expandable>
 </ParamField>
diff --git a/apps/docs/solutions/template-builder/configuration.mdx b/apps/docs/solutions/template-builder/configuration.mdx
@@ -21,6 +21,14 @@ Control which document is loaded and how users interact with it:
 **Editing mode** - Users can edit document content and insert fields.
 **Viewing mode** - Read-only document display, fields can still be inserted.
 
+Changing `mode` at runtime switches between editing and viewing without recreating the editor — no scroll jump or content flash:
+
+```tsx
+<SuperDocTemplateBuilder
+  document={{ source: file, mode: isEditing ? "editing" : "viewing" }}
+/>
+```
+
 ## Field system
 
 ### Available fields
diff --git a/packages/react/package.json b/packages/react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/react",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Official React wrapper for the SuperDoc document editor",
   "type": "module",
   "main": "./dist/index.cjs",
diff --git a/packages/sdk/langs/node/package.json b/packages/sdk/langs/node/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.cjs",
diff --git a/packages/sdk/langs/node/platforms/sdk-darwin-arm64/package.json b/packages/sdk/langs/node/platforms/sdk-darwin-arm64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk-darwin-arm64",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "os": [
     "darwin"
   ],
diff --git a/packages/sdk/langs/node/platforms/sdk-darwin-x64/package.json b/packages/sdk/langs/node/platforms/sdk-darwin-x64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk-darwin-x64",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "os": [
     "darwin"
   ],
diff --git a/packages/sdk/langs/node/platforms/sdk-linux-arm64/package.json b/packages/sdk/langs/node/platforms/sdk-linux-arm64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk-linux-arm64",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "os": [
     "linux"
   ],
diff --git a/packages/sdk/langs/node/platforms/sdk-linux-x64/package.json b/packages/sdk/langs/node/platforms/sdk-linux-x64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk-linux-x64",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "os": [
     "linux"
   ],
diff --git a/packages/sdk/langs/node/platforms/sdk-windows-x64/package.json b/packages/sdk/langs/node/platforms/sdk-windows-x64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk-windows-x64",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "os": [
     "win32"
   ],
diff --git a/packages/sdk/langs/python/platforms/superdoc-sdk-cli-darwin-arm64/pyproject.toml b/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.3.0"
+version = "1.4.0"
 description = "SuperDoc CLI binary for macOS ARM64 (Apple Silicon)"
 readme = "README.md"
 requires-python = ">=3.9"
diff --git a/packages/sdk/langs/python/platforms/superdoc-sdk-cli-darwin-x64/pyproject.toml b/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.3.0"
+version = "1.4.0"
 description = "SuperDoc CLI binary for macOS x64 (Intel)"
 readme = "README.md"
 requires-python = ">=3.9"
diff --git a/packages/sdk/langs/python/platforms/superdoc-sdk-cli-linux-arm64/pyproject.toml b/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.3.0"
+version = "1.4.0"
 description = "SuperDoc CLI binary for Linux ARM64"
 readme = "README.md"
 requires-python = ">=3.9"
diff --git a/packages/sdk/langs/python/platforms/superdoc-sdk-cli-linux-x64/pyproject.toml b/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.3.0"
+version = "1.4.0"
 description = "SuperDoc CLI binary for Linux x64"
 readme = "README.md"
 requires-python = ">=3.9"
diff --git a/packages/sdk/langs/python/platforms/superdoc-sdk-cli-windows-x64/pyproject.toml b/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.3.0"
+version = "1.4.0"
 description = "SuperDoc CLI binary for Windows x64"
 readme = "README.md"
 requires-python = ">=3.9"
diff --git a/packages/sdk/langs/python/pyproject.toml b/packages/sdk/langs/python/pyproject.toml
@@ -4,18 +4,18 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "superdoc-sdk"
-version = "1.3.0"
+version = "1.4.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.3.0; platform_system == 'Darwin' and (platform_machine == 'arm64' or platform_machine == 'aarch64' or platform_machine == 'ARM64')",
-  "superdoc-sdk-cli-darwin-x64==1.3.0; platform_system == 'Darwin' and (platform_machine == 'x86_64' or platform_machine == 'AMD64' or platform_machine == 'amd64')",
-  "superdoc-sdk-cli-linux-x64==1.3.0; platform_system == 'Linux' and (platform_machine == 'x86_64' or platform_machine == 'AMD64' or platform_machine == 'amd64')",
-  "superdoc-sdk-cli-linux-arm64==1.3.0; platform_system == 'Linux' and (platform_machine == 'arm64' or platform_machine == 'aarch64' or platform_machine == 'ARM64')",
-  "superdoc-sdk-cli-windows-x64==1.3.0; platform_system == 'Windows' and (platform_machine == 'x86_64' or platform_machine == 'AMD64' or platform_machine == 'amd64')",
+  "superdoc-sdk-cli-darwin-arm64==1.4.0; platform_system == 'Darwin' and (platform_machine == 'arm64' or platform_machine == 'aarch64' or platform_machine == 'ARM64')",
+  "superdoc-sdk-cli-darwin-x64==1.4.0; platform_system == 'Darwin' and (platform_machine == 'x86_64' or platform_machine == 'AMD64' or platform_machine == 'amd64')",
+  "superdoc-sdk-cli-linux-x64==1.4.0; platform_system == 'Linux' and (platform_machine == 'x86_64' or platform_machine == 'AMD64' or platform_machine == 'amd64')",
+  "superdoc-sdk-cli-linux-arm64==1.4.0; platform_system == 'Linux' and (platform_machine == 'arm64' or platform_machine == 'aarch64' or platform_machine == 'ARM64')",
+  "superdoc-sdk-cli-windows-x64==1.4.0; platform_system == 'Windows' and (platform_machine == 'x86_64' or platform_machine == 'AMD64' or platform_machine == 'amd64')",
 ]
 
 [tool.setuptools]
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk-workspace",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "private": true,
   "type": "module",
   "scripts": {
diff --git a/packages/sdk/version.json b/packages/sdk/version.json
@@ -1,3 +1,3 @@
 {
-  "sdkVersion": "1.3.0"
+  "sdkVersion": "1.4.0"
 }
diff --git a/packages/template-builder/src/defaults/FieldMenu.tsx b/packages/template-builder/src/defaults/FieldMenu.tsx
@@ -72,7 +72,7 @@ export const FieldMenu: React.FC<FieldMenuProps> = ({
       label: trimmedName,
       mode: fieldMode,
       fieldType: fieldType,
-      ...(fieldLocked && { lockMode: 'contentLocked' as const }),
+      lockMode: fieldLocked ? ('contentLocked' as const) : ('unlocked' as const),
     };
 
     try {
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@superdoc-dev/cli-darwin-arm64",`
`3`		`- "version": "0.5.0",`
	`3`	`+ "version": "0.6.0",`
`4`	`4`	`"os": [`
`5`	`5`	`"darwin"`
`6`	`6`	`],`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@superdoc-dev/cli-darwin-x64",`
`3`		`- "version": "0.5.0",`
	`3`	`+ "version": "0.6.0",`
`4`	`4`	`"os": [`
`5`	`5`	`"darwin"`
`6`	`6`	`],`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@superdoc-dev/cli-linux-arm64",`
`3`		`- "version": "0.5.0",`
	`3`	`+ "version": "0.6.0",`
`4`	`4`	`"os": [`
`5`	`5`	`"linux"`
`6`	`6`	`],`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@superdoc-dev/cli-linux-x64",`
`3`		`- "version": "0.5.0",`
	`3`	`+ "version": "0.6.0",`
`4`	`4`	`"os": [`
`5`	`5`	`"linux"`
`6`	`6`	`],`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@superdoc-dev/cli-windows-x64",`
`3`		`- "version": "0.5.0",`
	`3`	`+ "version": "0.6.0",`
`4`	`4`	`"os": [`
`5`	`5`	`"win32"`
`6`	`6`	`],`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@superdoc-dev/react",`
`3`		`- "version": "0.1.0",`
	`3`	`+ "version": "1.0.0",`
`4`	`4`	`"description": "Official React wrapper for the SuperDoc document editor",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./dist/index.cjs",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@superdoc-dev/sdk",`
`3`		`- "version": "1.3.0",`
	`3`	`+ "version": "1.4.0",`
`4`	`4`	`"private": false,`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./dist/index.cjs",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@superdoc-dev/sdk-darwin-arm64",`
`3`		`- "version": "1.3.0",`
	`3`	`+ "version": "1.4.0",`
`4`	`4`	`"os": [`
`5`	`5`	`"darwin"`
`6`	`6`	`],`