fix(super-editor): structural text.rewrite for multi-block replacements (#2733)

* fix(super-editor): create paragraph nodes for multi-block text.rewrite on range targets

* fix(super-editor): split replacement text on paragraph breaks for multi-paragraph rewrites

* Revert "fix(super-editor): split replacement text on paragraph breaks for multi-paragraph rewrites"

This reverts commit 429b207.

* Revert "fix(super-editor): create paragraph nodes for multi-block text.rewrite on range targets"

This reverts commit 1284c55.

* fix(super-editor): implement structural text.rewrite for multi-block replacements

- Added support for replacing entire textblocks with multiple paragraphs when the replacement text normalizes to multiple blocks.
- Enhanced the `executeTextRewrite` function to handle structural rewrites and maintain paragraph attributes.
- Introduced utility functions to manage text range and paragraph node creation for improved text handling during rewrites.

* docs(system-prompt): add clarification on document structure and paragraph identification

* fix(super-editor): address PR review — shared identity helper, position-based textblock check

* fix(super-editor): preserve multi-block tracked rewrites

Author: tupizz

examples/collaboration/ai-node-sdk/Makefile

@@ -1,4 +1,4 @@
-.PHONY: install dev dev-local dev-server dev-client link-local-sdk rebuild-local-sdk restore-npm-sdk kill clean help
+.PHONY: install dev dev-local dev-server dev-client build-local-artifacts link-local-sdk rebuild-local-sdk restore-npm-sdk kill clean help
 
 # ─── Config ───────────────────────────────────────────────────────────────────
 
@@ -82,7 +82,7 @@ dev: check-env kill restore-npm-sdk ## Start with npm SDK (default)
 		"cd server && npm run dev" \
 		"cd client && $(PNPM) run dev"
 
-dev-local: check-env kill link-local-sdk ## Start with local SDK (built from monorepo)
+dev-local: check-env kill link-local-sdk ## Start with local SDK (always rebuilds local artifacts)
 	@echo ""
 	@echo "  Server → http://localhost:8090 + ws://localhost:8081 (local SDK)"
 	@echo "  Client → http://localhost:5173"
@@ -109,25 +109,32 @@ restore-npm-sdk: ## Restore SDK from npm if currently symlinked
 
 # ─── Local SDK ────────────────────────────────────────────────────────────────
 
-link-local-sdk: ## Build and link local SuperDoc SDK + CLI
+build-local-artifacts: ## Rebuild local editor, SDK, and CLI artifacts used by dev-local
+	@echo "Rebuilding local SuperDoc artifacts..."
+	@echo "  Building @superdoc/super-editor..."
+	@cd $(ROOT) && $(PNPM) --filter @superdoc/super-editor run build
+	@echo "  Building superdoc..."
+	@cd $(ROOT) && $(PNPM) --filter superdoc run build:es
+	@echo "  Building @superdoc-dev/react..."
+	@cd $(ROOT) && $(PNPM) --filter @superdoc-dev/react run build
+	@echo "  Building @superdoc-dev/sdk..."
+	@cd $(ROOT) && $(PNPM) --filter @superdoc-dev/sdk run build
+	@echo "  Building CLI binary..."
+	@cd $(ROOT) && $(PNPM) --filter @superdoc-dev/cli run build:native:host
+	@echo "✓ Local artifacts rebuilt"
+
+link-local-sdk: build-local-artifacts ## Build and link local SuperDoc SDK + CLI
 	@echo "Linking local SuperDoc SDK ($(CLI_TARGET))..."
-	@# 1. Build CLI native binary if not already built
-	@if [ ! -f $(CLI_ARTIFACT) ]; then \
-		echo "  Building CLI binary..."; \
-		cd $(ROOT) && $(PNPM) --filter @superdoc-dev/cli run build:native:host; \
-	else \
-		echo "  CLI binary found"; \
-	fi
-	@# 2. Ensure server node_modules exists
+	@# 1. Ensure server node_modules exists
 	@if [ ! -d server/node_modules ]; then \
 		echo "  Installing server deps first..."; \
 		cd server && npm install; \
 	fi
-	@# 3. Replace npm SDK with symlink to workspace source
+	@# 2. Replace npm SDK with symlink to workspace source
 	@rm -rf server/node_modules/@superdoc-dev/sdk
 	@ln -sf $(SDK_SRC) server/node_modules/@superdoc-dev/sdk
 	@echo "  ✓ Linked SDK → $(SDK_SRC)"
-	@# 4. Place CLI binary where the workspace SDK can find it via require.resolve
+	@# 3. Place CLI binary where the workspace SDK can find it via require.resolve
 	@#    Node follows the symlink real path, so the binary must be in the
 	@#    workspace SDK's own node_modules, not the server's.
 	@mkdir -p $(SDK_SRC)/node_modules/$(CLI_PKG)/bin
@@ -136,13 +143,7 @@ link-local-sdk: ## Build and link local SuperDoc SDK + CLI
 	@echo "  ✓ Linked CLI binary"
 	@echo "✓ Local SDK ready"
 
-rebuild-local-sdk: ## Rebuild CLI binary and re-link
-	@echo "Rebuilding CLI binary..."
-	@cd $(ROOT) && $(PNPM) --filter @superdoc-dev/cli run build:native:host
-	@mkdir -p $(SDK_SRC)/node_modules/$(CLI_PKG)/bin
-	@cp $(CLI_ARTIFACT) $(SDK_SRC)/node_modules/$(CLI_PKG)/bin/$(CLI_BINARY)
-	@chmod +x $(SDK_SRC)/node_modules/$(CLI_PKG)/bin/$(CLI_BINARY)
-	@echo "✓ CLI binary updated"
+rebuild-local-sdk: link-local-sdk ## Rebuild local artifacts and refresh links
 
 # ─── Cleanup ──────────────────────────────────────────────────────────────────
 

packages/sdk/langs/browser/src/intent-dispatch.ts

@@ -54,6 +54,8 @@ export function dispatchIntentTool(
           return execute('doc.format.paragraph.setIndentation', rest);
         case 'set_spacing':
           return execute('doc.format.paragraph.setSpacing', rest);
+        case 'set_flow_options':
+          return execute('doc.format.paragraph.setFlowOptions', rest);
         case 'set_direction':
           return execute('doc.format.paragraph.setDirection', rest);
         default:
@@ -67,6 +69,8 @@ export function dispatchIntentTool(
           return execute('doc.create.paragraph', rest);
         case 'heading':
           return execute('doc.create.heading', rest);
+        case 'table':
+          return execute('doc.create.table', rest);
         default:
           throw new Error(`Unknown action for superdoc_create: ${action}`);
       }