fix: prep for multi editor versions - no logical changes. structure only (#2591)

* fix: prep for multi editor versions - no logical changes. structure only

* chore: fix broken path in tests after refactor

Author: harbournick

.github/scripts/risk-assess.mjs

@@ -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-label.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.test.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/workflows/spec-review.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 }}

.gitignore

@@ -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

.prettierignore

@@ -23,8 +23,8 @@ packages/superdoc/src/components/PdfViewer/helpers/pdfjs-worker.js
 # Test data directories
 **/data/**
 **/data
-packages/super-editor/src/tests/data
-packages/super-editor/src/tests/data/**
+packages/super-editor/src/editors/v1/tests/data
+packages/super-editor/src/editors/v1/tests/data/**
 src/tests/data
 src/tests/data/**
 tests/data

AGENTS.md

@@ -21,14 +21,14 @@ PM Doc (hidden) → pm-adapter → FlowBlock[] → layout-engine → Layout[] 
 |--------|-------|
 | How something looks | `pm-adapter/` (data) + `painters/dom/` (rendering) |
 | Style resolution | `style-engine/` |
-| Editing behavior | `super-editor/src/extensions/` |
+| Editing behavior | `super-editor/src/editors/v1/extensions/` |
 
 **Do NOT** add ProseMirror decoration plugins for visual styling — DomPainter handles rendering.
 
 ### State Communication
 
 State flows from super-editor → Layout Engine via:
-- `PresentationEditor.ts` listens to editor events (`super-editor/src/core/presentation-editor/`)
+- `PresentationEditor.ts` listens to editor events (`super-editor/src/editors/v1/core/presentation-editor/`)
 - Calls DomPainter methods to update state
 - DomPainter re-renders with new state
 
@@ -58,10 +58,10 @@ tests/visual/        Visual regression tests (Playwright + R2 baselines)
 | Task | Location |
 |------|----------|
 | React integration | `packages/react/src/SuperDocEditor.tsx` |
-| Editing features | `super-editor/src/extensions/` |
+| Editing features | `super-editor/src/editors/v1/extensions/` |
 | Presentation mode visuals | `layout-engine/painters/dom/src/features/feature-registry.ts` → feature module |
 | Rendering orchestration | `layout-engine/painters/dom/src/renderer.ts` |
-| DOCX import/export | `super-editor/src/core/super-converter/` |
+| DOCX import/export | `super-editor/src/editors/v1/core/super-converter/` |
 | Style resolution | `layout-engine/style-engine/` |
 | Main entry point (Vue) | `superdoc/src/SuperDoc.vue` |
 | Visual regression tests | `tests/visual/` (see its CLAUDE.md) |
@@ -86,7 +86,7 @@ tests/visual/        Visual regression tests (Playwright + R2 baselines)
 
 - **Visual rendering**: Check `painters/dom/src/features/feature-registry.ts` to find the feature module, then modify it. If no module exists yet, create one (see layout-engine CLAUDE.md). Feed data via `pm-adapter/`
 - **Style resolution**: Modify `style-engine/` — called by pm-adapter during conversion
-- **Editing commands/behavior**: Modify `super-editor/src/extensions/`
+- **Editing commands/behavior**: Modify `super-editor/src/editors/v1/extensions/`
 - **State bridging**: Modify `PresentationEditor.ts`
 
 ## Document API Contract

CONTRIBUTING.md

@@ -61,7 +61,7 @@ packages/
   superdoc/              Main entry point (npm: superdoc)
   react/                 React wrapper (@superdoc-dev/react)
   super-editor/          ProseMirror editor core
-    src/
+    src/editors/v1/
       core/
         super-converter/ DOCX import/export (OOXML ↔ ProseMirror)
       extensions/        Editing behaviors (bold, lists, tables, etc.)
@@ -85,8 +85,8 @@ tests/visual/            Visual regression tests (Playwright)
 | How something looks (visual rendering) | `layout-engine/painters/dom/` |
 | Style resolution (fonts, colors, borders) | `layout-engine/style-engine/` |
 | Data flowing from editor to renderer | `layout-engine/pm-adapter/` |
-| Editing behavior (keyboard, commands) | `super-editor/src/extensions/` |
-| DOCX import/export | `super-editor/src/core/super-converter/` |
+| Editing behavior (keyboard, commands) | `super-editor/src/editors/v1/extensions/` |
+| DOCX import/export | `super-editor/src/editors/v1/core/super-converter/` |
 | React integration | `packages/react/` |
 | Main entry point (Vue) | `packages/superdoc/` |
 | Visual regression tests | `tests/visual/` |
@@ -108,8 +108,8 @@ These are areas where community contributions are especially welcome. Check [iss
 | Test coverage | Easy-Medium | `tests/visual/` | Add tests for existing features |
 | Rendering parity | Medium | `layout-engine/painters/dom/` | Open a .docx in Word and SuperDoc, fix visual differences |
 | Browser compatibility | Medium | `super-editor/`, `layout-engine/` | Fix Firefox/Safari-specific bugs |
-| Copy/paste | Medium | `super-editor/src/extensions/` | Fix formatting loss when pasting from Word, Google Docs, browsers |
-| DOCX import coverage | Medium-Hard | `super-editor/src/core/super-converter/` | Support additional OOXML tags and elements |
+| Copy/paste | Medium | `super-editor/src/editors/v1/extensions/` | Fix formatting loss when pasting from Word, Google Docs, browsers |
+| DOCX import coverage | Medium-Hard | `super-editor/src/editors/v1/core/super-converter/` | Support additional OOXML tags and elements |
 
 ## Your First PR
 

THIRD_PARTY_LICENSES.md

@@ -6,7 +6,7 @@ This project includes code from third-party libraries. Their licenses are listed
 
 ## rtf.js (EMF/WMF Rendering)
 
-**Location:** `packages/super-editor/src/core/super-converter/v3/handlers/wp/helpers/rtfjs/`
+**Location:** `packages/super-editor/src/editors/v1/core/super-converter/v3/handlers/wp/helpers/rtfjs/`
 
 **Source:** https://github.com/nicktf/rtf.js
 

apps/cli/src/__tests__/cli.test.ts

@@ -63,7 +63,7 @@ const CLI_PACKAGE_JSON_PATH = join(import.meta.dir, '../../package.json');
 const REPO_ROOT = join(import.meta.dir, '../../../..');
 const ENCRYPTED_FIXTURE_SOURCE = join(
   REPO_ROOT,
-  'packages/super-editor/src/core/ooxml-encryption/fixtures/encrypted-advanced-text.docx',
+  'packages/super-editor/src/editors/v1/core/ooxml-encryption/fixtures/encrypted-advanced-text.docx',
 );
 const execFileAsync = promisify(execFile);
 const ZIP_MAX_BUFFER_BYTES = 10 * 1024 * 1024;