Merge branch 'main' into tadeu/sd-3005-feature-bibliography

Author: harbournick

.github/scripts/risk-label.mjs

@@ -7,7 +7,7 @@ import { readFileSync } from 'node:fs';
 const CRITICAL_PATHS = [
   'packages/layout-engine/style-engine/',
   'packages/layout-engine/layout-engine/',
-  'packages/layout-engine/pm-adapter/',
+  'packages/pm-adapter/',
   'packages/layout-engine/layout-bridge/',
   'packages/layout-engine/measuring/',
   'packages/layout-engine/painters/',

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

@@ -85,7 +85,7 @@ describe('classify', () => {
 
   it('critical: pm-adapter', () => {
     assert.equal(
-      classify(['packages/layout-engine/pm-adapter/src/foo.js']).level,
+      classify(['packages/pm-adapter/src/foo.js']).level,
       'critical',
     );
   });

AGENTS.md

@@ -9,25 +9,31 @@ SuperDoc uses its own rendering pipeline. ProseMirror stores document state; it
 ```
 .docx
   → super-converter parses OOXML into the hidden PM doc
-  → pm-adapter reads PM state and resolved styles
+  → v1 layout-adapter (super-editor: src/editors/v1/core/layout-adapter)
+    reads PM state and resolved styles
   → FlowBlock[]
   → layout-engine paginates
   → ResolvedLayout
   → DomPainter paints DOM
 ```
 
+- The v1 ProseMirror → `FlowBlock[]` adapter is owned by `@superdoc/super-editor`
+  (`src/editors/v1/core/layout-adapter`). It is v1 SuperEditor's projection from
+  hidden ProseMirror state into layout data. v2 owns its own projection adapter.
+  `layout-engine` runtime packages consume `FlowBlock[]` and layout contracts
+  only; they must never import either concrete adapter.
 - `PresentationEditor` wraps a hidden ProseMirror `Editor`. Its contenteditable DOM is never shown. PresentationEditor bridges editor events into layout/paint state; do not resolve OOXML semantics there.
 - **DomPainter** (`layout-engine/painters/dom/`) owns all visual rendering.
-- Style-resolved properties flow `pm-adapter` → DomPainter. Do not style document content with PM decorations.
+- Style-resolved properties flow `layout-adapter` → DomPainter. Do not style document content with PM decorations.
 
 ### Where To Put Your Change
 
 | Concern | Where | Rule |
 |---|---|---|
 | DOCX import/export | `super-editor/src/editors/v1/core/super-converter/` | Parse and preserve OOXML, style refs, inline properties. Do not bake resolved formatting into direct attrs. |
 | Style cascade | `layout-engine/style-engine/` | Single source of truth for defaults, styles, conditional formatting, inline overrides. |
-| Static document visuals | `pm-adapter/` data + `layout-engine/painters/dom/` rendering | Feed typed data into DomPainter. Do not style static content with PM decorations. |
-| Direction-aware properties | `layout-engine/painters/dom/` | DomPainter mirrors at paint time for `w:bidiVisual`. pm-adapter stores logical sides LTR-default. Pre-mirroring upstream is a double-swap. See `packages/layout-engine/pm-adapter/src/direction/README.md`. |
+| Static document visuals | v1 `core/layout-adapter/` data + `layout-engine/painters/dom/` rendering | Feed typed data into DomPainter. Do not style static content with PM decorations. |
+| Direction-aware properties | `layout-engine/painters/dom/` | DomPainter mirrors at paint time for `w:bidiVisual`. The v1 layout-adapter stores logical sides LTR-default. Pre-mirroring upstream is a double-swap. See `packages/super-editor/src/editors/v1/core/layout-adapter/direction/README.md`. |
 | Editing behavior | `super-editor/src/editors/v1/extensions/` | Commands, keybindings, editor plugins. Do not duplicate cascade or render document visuals here. |
 | Final DOM rendering | `layout-engine/painters/dom/` | Render `ResolvedLayout`. Paint-time transforms (e.g. RTL mirror) live here. |
 | New doc-api operation | `packages/document-api/src/contract/operation-definitions.ts` | Contract-first; touches 4 files. See `packages/document-api/README.md`. |
@@ -39,8 +45,8 @@ For specialized boundaries (interaction mapping, geometry/pagination, ephemeral
 Before adding a visual or direction-aware path, run:
 
 ```bash
-# Painter must not import upstream packages.
-rg "@superdoc/(pm-adapter|style-engine|layout-bridge|layout-resolved)" packages/layout-engine/painters/dom/src
+# Painter must not import upstream packages or the concrete v1 adapter.
+rg "@superdoc/(super-editor|style-engine|layout-bridge|layout-resolved)" packages/layout-engine/painters/dom/src
 ```
 
 More checks in `packages/layout-engine/AGENTS.md`.

CONTRIBUTING.md

@@ -47,13 +47,17 @@ SuperDoc uses its own rendering pipeline -- ProseMirror is NOT used for visual o
 ```
 DOCX File
   → super-converter (parse OOXML into ProseMirror document)
-    → pm-adapter (convert PM nodes into FlowBlocks)
+    → v1 layout-adapter (super-editor: convert PM nodes into FlowBlocks)
       → layout-engine (paginate FlowBlocks into Layouts)
         → DomPainter (render Layouts to DOM)
 ```
 
 A hidden ProseMirror `Editor` instance manages document state and editing commands, but its DOM is never shown to the user. All visual rendering goes through DomPainter.
 
+The PM → FlowBlock adapter is owned by `super-editor`
+(`src/editors/v1/core/layout-adapter`), not by `layout-engine`. The layout
+engine packages consume `FlowBlock[]` and shared layout contracts only.
+
 ### Project Structure
 
 ```
@@ -64,9 +68,9 @@ packages/
     src/editors/v1/
       core/
         super-converter/ DOCX import/export (OOXML ↔ ProseMirror)
+        layout-adapter/  ProseMirror → FlowBlock[] projection (v1-owned)
       extensions/        Editing behaviors (bold, lists, tables, etc.)
   layout-engine/         Layout & pagination pipeline
-    pm-adapter/          ProseMirror → Layout bridge
     layout-engine/       Pagination algorithms
     painters/dom/        DOM rendering (DomPainter)
     style-engine/        OOXML style resolution & cascade
@@ -84,7 +88,7 @@ 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/` |
+| Data flowing from editor to renderer | `super-editor/src/editors/v1/core/layout-adapter/` |
 | 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/` |

README.md

@@ -72,6 +72,14 @@ const superdoc = new SuperDoc({
 });
 ```
 
+Optional layered CSS mode:
+
+```css
+@layer reset, superdoc, app;
+@import 'superdoc/style.layered.css';
+@import 'your-app.css' layer(app);
+```
+
 Or use the CDN:
 
 ```html

apps/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli",
-  "version": "0.13.1",
+  "version": "0.15.0",
   "type": "module",
   "bin": {
     "superdoc": "./dist/index.js"
@@ -46,7 +46,6 @@
   },
   "devDependencies": {
     "@superdoc/document-api": "workspace:*",
-    "@superdoc/pm-adapter": "workspace:*",
     "@superdoc/super-editor": "workspace:*",
     "@types/bun": "catalog:",
     "@types/node": "catalog:",

apps/cli/platforms/cli-darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli-darwin-arm64",
-  "version": "0.13.1",
+  "version": "0.15.0",
   "os": [
     "darwin"
   ],

apps/cli/platforms/cli-darwin-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli-darwin-x64",
-  "version": "0.13.1",
+  "version": "0.15.0",
   "os": [
     "darwin"
   ],

apps/cli/platforms/cli-linux-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli-linux-arm64",
-  "version": "0.13.1",
+  "version": "0.15.0",
   "os": [
     "linux"
   ],

apps/cli/platforms/cli-linux-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli-linux-x64",
-  "version": "0.13.1",
+  "version": "0.15.0",
   "os": [
     "linux"
   ],