Merge branch 'main' into stable

Author: harbournick

.github/scripts/package-lock.json

@@ -104,13 +104,13 @@ function buildHaikuPrompt(files, diff) {
 
 ## Critical paths (rendering/layout can break):
 - packages/layout-engine/ (style-engine, layout-engine, pm-adapter, layout-bridge, measuring, painters)
-- packages/super-editor/src/core/super-converter/ (DOCX import/export)
-- packages/super-editor/src/core/presentation-editor/ (editor↔layout bridge)
+- packages/super-editor/src/editors/v1/core/super-converter/ (DOCX import/export)
+- packages/super-editor/src/editors/v1/core/presentation-editor/ (editor↔layout bridge)
 - packages/superdoc/src/core/ (main entry core)
 - packages/word-layout/
 
 ## Sensitive paths (editing behavior):
-- packages/super-editor/src/extensions/ and src/core/
+- packages/super-editor/src/editors/v1/extensions/ and src/editors/v1/core/
 - packages/superdoc/src/
 - packages/layout-engine/contracts/
 - packages/esign/, shared/
@@ -181,8 +181,8 @@ function buildSonnetPrompt(pr, title, diff, haikuResult) {
 ## Project Context
 Critical subsystems:
 - **Layout Engine** (packages/layout-engine/): style resolution, pagination, DOM painting, PM adapter
-- **Super Converter** (packages/super-editor/src/core/super-converter/): DOCX import/export
-- **Presentation Editor** (packages/super-editor/src/core/presentation-editor/): bridges editor ↔ layout
+- **Super Converter** (packages/super-editor/src/editors/v1/core/super-converter/): DOCX import/export
+- **Presentation Editor** (packages/super-editor/src/editors/v1/core/presentation-editor/): bridges editor ↔ layout
 - **Word Layout** (packages/word-layout/): Word document layout algorithms
 
 Sensitive: editor extensions, editor core, superdoc package, shared utilities, esign.

.github/scripts/risk-assess.mjs

@@ -11,15 +11,15 @@ const CRITICAL_PATHS = [
   'packages/layout-engine/layout-bridge/',
   'packages/layout-engine/measuring/',
   'packages/layout-engine/painters/',
-  'packages/super-editor/src/core/super-converter/',
-  'packages/super-editor/src/core/presentation-editor/',
+  'packages/super-editor/src/editors/v1/core/super-converter/',
+  'packages/super-editor/src/editors/v1/core/presentation-editor/',
   'packages/superdoc/src/core/',
   'packages/word-layout/',
 ];
 
 const SENSITIVE_PATHS = [
-  'packages/super-editor/src/extensions/',
-  'packages/super-editor/src/core/',
+  'packages/super-editor/src/editors/v1/extensions/',
+  'packages/super-editor/src/editors/v1/core/',
   'packages/superdoc/src/',
   'packages/layout-engine/contracts/',
   'packages/esign/',

.github/scripts/risk-label.mjs

@@ -19,7 +19,7 @@ describe('classify', () => {
 
   it('sensitive: extensions', () => {
     assert.equal(
-      classify(['packages/super-editor/src/extensions/bold/bold.ts']).level,
+      classify(['packages/super-editor/src/editors/v1/extensions/bold/bold.ts']).level,
       'sensitive',
     );
   });
@@ -70,7 +70,7 @@ describe('classify', () => {
   it('critical: super-converter', () => {
     assert.equal(
       classify([
-        'packages/super-editor/src/core/super-converter/v2/importer/foo.js',
+        'packages/super-editor/src/editors/v1/core/super-converter/v2/importer/foo.js',
       ]).level,
       'critical',
     );
@@ -107,7 +107,7 @@ describe('classify', () => {
   it('critical: presentation-editor', () => {
     assert.equal(
       classify([
-        'packages/super-editor/src/core/presentation-editor/PresentationEditor.ts',
+        'packages/super-editor/src/editors/v1/core/presentation-editor/PresentationEditor.ts',
       ]).level,
       'critical',
     );
@@ -130,31 +130,31 @@ describe('classify', () => {
   it('highest risk wins when mixed', () => {
     const result = classify([
       'packages/layout-engine/style-engine/src/resolve.js',
-      'packages/super-editor/src/extensions/bold/bold.ts',
+      'packages/super-editor/src/editors/v1/extensions/bold/bold.ts',
       'apps/docs/guides/foo.mdx',
     ]);
     assert.equal(result.level, 'critical');
   });
 
-  it('super-editor/src/core/ non-critical subpath is sensitive', () => {
+  it('super-editor/src/editors/v1/core/ non-critical subpath is sensitive', () => {
     assert.equal(
-      classify(['packages/super-editor/src/core/helpers/utils.js']).level,
+      classify(['packages/super-editor/src/editors/v1/core/helpers/utils.js']).level,
       'sensitive',
     );
   });
 
   it('downgrade: critical test-only becomes sensitive', () => {
     const result = classify([
       'packages/layout-engine/style-engine/__tests__/resolve.test.js',
-      'packages/super-editor/src/core/super-converter/__tests__/import.test.js',
+      'packages/super-editor/src/editors/v1/core/super-converter/__tests__/import.test.js',
     ]);
     assert.equal(result.level, 'sensitive');
     assert.equal(result.downgraded, true);
   });
 
   it('downgrade: sensitive test-only becomes low', () => {
     const result = classify([
-      'packages/super-editor/src/extensions/bold/bold.test.ts',
+      'packages/super-editor/src/editors/v1/extensions/bold/bold.test.ts',
     ]);
     assert.equal(result.level, 'low');
     assert.equal(result.downgraded, true);

.github/scripts/risk-label.test.mjs

@@ -7,7 +7,6 @@ on:
   pull_request:
     branches: [main, 'release/**']
     paths-ignore:
-      - '.github/workflows/**'
       - 'apps/docs/**'
       - 'apps/mcp/**'
       - 'apps/vscode-ext/**'
@@ -26,7 +25,7 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  validate:
+  build:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
@@ -40,7 +39,7 @@ jobs:
 
       - uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.10
+          bun-version: 1.3.11
 
       - name: Install canvas system dependencies
         run: |
@@ -72,24 +71,109 @@ jobs:
       - name: Typecheck
         run: pnpm run type-check
 
-      - name: Run unit tests
-        run: pnpm test
+  unit-tests:
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - name: super-editor-1
+            shard: '1/4'
+          - name: super-editor-2
+            shard: '2/4'
+          - name: super-editor-3
+            shard: '3/4'
+          - name: super-editor-4
+            shard: '4/4'
+          - name: other-packages
+            shard: ''
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.11
+
+      - name: Install canvas system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            build-essential \
+            libcairo2-dev \
+            libpango1.0-dev \
+            libjpeg-dev \
+            libgif-dev \
+            librsvg2-dev \
+            libpixman-1-dev
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build
+        run: pnpm run build
+
+      - name: Run super-editor tests (shard ${{ matrix.shard }})
+        if: matrix.name != 'other-packages'
+        working-directory: packages/super-editor
+        env:
+          NODE_OPTIONS: '--max-old-space-size=4096'
+        run: >-
+          pnpm exec vitest run --pool forks --minWorkers 1 --maxWorkers 1
+          --shard=${{ matrix.shard }}
+          --exclude='**/decrypt-docx.integration*'
+          --exclude='**/contract-conformance*'
+
+      - name: Run other package vitest tests
+        if: matrix.name == 'other-packages'
+        env:
+          NODE_OPTIONS: '--max-old-space-size=4096'
+          VITEST_MAX_WORKERS: '1'
+          VITEST_MIN_WORKERS: '1'
+        run: pnpm exec vitest run '--project=!*super-editor*'
+
+      - name: Run bun tests
+        if: matrix.name == 'other-packages'
+        run: |
+          pnpm -r --parallel \
+            --filter @superdoc/document-api \
+            --filter @superdoc/layout-engine --filter @superdoc/style-engine \
+            --filter @superdoc/geometry-utils --filter @superdoc/word-layout \
+            --filter @superdoc/common --filter @font-utils \
+            --filter @locale-utils --filter @url-validation \
+            test
+
+      - name: Run SDK scripts tests
+        if: matrix.name == 'other-packages'
+        run: pnpm --prefix packages/sdk run test:scripts
 
       - name: Run memory profiling tests (non-blocking)
+        if: matrix.name == 'other-packages'
         continue-on-error: true
         run: pnpm --filter @superdoc/layout-tests run test:memory
 
       - name: Run slow tests
+        if: matrix.name == 'other-packages'
         run: pnpm test:slow
 
       - name: Install Playwright for UMD smoke test
+        if: matrix.name == 'other-packages'
         run: pnpm --filter @superdoc/umd-smoke-test exec playwright install --with-deps chromium
 
       - name: Run UMD smoke test
+        if: matrix.name == 'other-packages'
         working-directory: packages/superdoc/tests/umd-smoke
         run: pnpm test
 
   cli-tests:
+    needs: build
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
@@ -103,7 +187,7 @@ jobs:
 
       - uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.10
+          bun-version: 1.3.11
 
       - name: Install dependencies
         run: pnpm install
@@ -113,3 +197,14 @@ jobs:
 
       - name: Run CLI tests
         run: pnpm run test:cli
+
+  validate:
+    if: always()
+    needs: [build, unit-tests, cli-tests]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check results
+        run: |
+          if [[ "${{ contains(needs.*.result, 'failure') }}" == "true" ]]; then
+            exit 1
+          fi

.github/workflows/ci-superdoc.yml

@@ -8,6 +8,12 @@ on:
       - main
     paths:
       - 'packages/esign/**'
+      - 'packages/superdoc/**'
+      - 'packages/layout-engine/**'
+      - 'packages/super-editor/**'
+      - 'packages/ai/**'
+      - 'packages/word-layout/**'
+      - 'packages/preset-geometry/**'
       - 'pnpm-workspace.yaml'
       - '!**/*.md'
   workflow_dispatch:

.github/workflows/release-esign.yml

@@ -8,6 +8,12 @@ on:
       - main
     paths:
       - 'packages/template-builder/**'
+      - 'packages/superdoc/**'
+      - 'packages/layout-engine/**'
+      - 'packages/super-editor/**'
+      - 'packages/ai/**'
+      - 'packages/word-layout/**'
+      - 'packages/preset-geometry/**'
       - 'pnpm-workspace.yaml'
       - '!**/*.md'
   workflow_dispatch:

.github/workflows/release-template-builder.yml

@@ -5,9 +5,9 @@ on:
   pull_request:
     types: [opened]
     paths:
-      - 'packages/super-editor/src/core/super-converter/v2/importer/**'
-      - 'packages/super-editor/src/core/super-converter/v2/exporter/**'
-      - 'packages/super-editor/src/core/super-converter/v3/handlers/**'
+      - 'packages/super-editor/src/editors/v1/core/super-converter/v2/importer/**'
+      - 'packages/super-editor/src/editors/v1/core/super-converter/v2/exporter/**'
+      - 'packages/super-editor/src/editors/v1/core/super-converter/v3/handlers/**'
 
 concurrency:
   group: spec-review-${{ github.event.pull_request.number }}

.github/workflows/spec-review.yml

@@ -76,9 +76,9 @@ jobs:
           else
             echo "Merge conflict — attempting auto-resolution of release artifacts..."
 
-            # Auto-resolve expected conflicts: package.json version and CHANGELOG.md.
+            # Auto-resolve expected conflicts: package.json versions.
             # For these files, keep main's version (semantic-release manages them per-branch).
-            for f in packages/superdoc/package.json packages/superdoc/CHANGELOG.md; do
+            for f in packages/superdoc/package.json packages/esign/package.json packages/template-builder/package.json apps/vscode-ext/package.json; do
               if git diff --name-only --diff-filter=U | grep -qF "$f"; then
                 echo "  Auto-resolving $f (keeping main's version)"
                 git checkout --ours "$f"

.github/workflows/sync-patches.yml

@@ -35,7 +35,7 @@ lerna-debug.log*
 .vitepress/.cache
 .vitepress/dist
 
-packages/super-editor/src/tests/data/*/
+packages/super-editor/src/editors/v1/tests/data/*/
 
 packages/word-layout/tests/**/*.js
 packages/word-layout/tests/**/*.d.ts
@@ -75,6 +75,7 @@ tests/layout-snapshots
 tests/layout/candidate/
 tests/layout/reference/
 tests/layout/reports/
+tmp/layout-compare/
 test-corpus/
 .pnpm-store
 devtools/visual-testing/pnpm-lock.yaml