@beyondwork/docx-react-component 1.0.110 → 1.0.111

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/package.json +1 -1
  2. package/src/api/public-types.ts +3 -0
  3. package/src/model/layout/page-graph-types.ts +33 -0
  4. package/src/runtime/geometry/adjacent-geometry-intake.ts +373 -5
  5. package/src/runtime/geometry/caret-geometry.ts +219 -7
  6. package/src/runtime/geometry/geometry-index.ts +35 -10
  7. package/src/runtime/geometry/object-handles.ts +42 -1
  8. package/src/runtime/layout/index.ts +3 -0
  9. package/src/runtime/layout/inert-layout-facet.ts +13 -0
  10. package/src/runtime/layout/layout-engine-instance.ts +2 -0
  11. package/src/runtime/layout/layout-engine-version.ts +32 -2
  12. package/src/runtime/layout/layout-facet-types.ts +3 -0
  13. package/src/runtime/layout/page-graph.ts +81 -7
  14. package/src/runtime/layout/project-block-fragments.ts +144 -1
  15. package/src/runtime/layout/public-facet.ts +160 -0
  16. package/src/runtime/scopes/adjacent-geometry-evidence.ts +456 -0
  17. package/src/runtime/scopes/compile-scope-bundle.ts +8 -0
  18. package/src/runtime/scopes/evidence.ts +16 -0
  19. package/src/runtime/scopes/index.ts +13 -0
  20. package/src/runtime/scopes/semantic-scope-types.ts +67 -0
  21. package/src/ui-tailwind/debug/layer11-consumer-readiness.ts +104 -0
  22. package/src/ui-tailwind/editor-surface/pm-page-break-decorations.ts +50 -5
  23. package/src/ui-tailwind/editor-surface/tw-prosemirror-surface.tsx +26 -0
  24. package/src/README.md +0 -85
  25. package/src/api/README.md +0 -26
  26. package/src/api/v3/README.md +0 -91
  27. package/src/component-inventory.md +0 -99
  28. package/src/core/README.md +0 -10
  29. package/src/core/commands/README.md +0 -3
  30. package/src/core/schema/README.md +0 -3
  31. package/src/core/selection/README.md +0 -3
  32. package/src/core/state/README.md +0 -3
  33. package/src/io/README.md +0 -10
  34. package/src/io/export/README.md +0 -3
  35. package/src/io/normalize/README.md +0 -3
  36. package/src/io/ooxml/README.md +0 -3
  37. package/src/io/opc/README.md +0 -3
  38. package/src/model/README.md +0 -3
  39. package/src/preservation/README.md +0 -3
  40. package/src/review/README.md +0 -16
  41. package/src/review/store/README.md +0 -3
  42. package/src/runtime/README.md +0 -3
  43. package/src/ui/README.md +0 -30
  44. package/src/ui/comments/README.md +0 -3
  45. package/src/ui/compatibility/README.md +0 -3
  46. package/src/ui/editor-surface/README.md +0 -3
  47. package/src/ui/review/README.md +0 -3
  48. package/src/ui/status/README.md +0 -3
  49. package/src/ui/theme/README.md +0 -3
  50. package/src/ui/toolbar/README.md +0 -3
  51. package/src/ui-tailwind/debug/README.md +0 -22
  52. package/src/validation/README.md +0 -3
@@ -1,3 +0,0 @@
1
- # Model
2
-
3
- Canonical document envelope types, schema versions, persisted snapshots, and migration contracts belong here.
@@ -1,3 +0,0 @@
1
- # Preservation
2
-
3
- Unsupported OOXML capture, retention, untouched package-part preservation, and export reattachment logic belong here.
@@ -1,16 +0,0 @@
1
- # Review
2
-
3
- Comments, anchors, revisions, remap helpers, and accept/reject behavior belong here.
4
-
5
- Frozen Wave 1 contract:
6
-
7
- - comments and revisions live in the canonical `review` store, not in the content tree
8
- - review anchors use canonical position ranges or detached-anchor payloads, never DOM paths
9
- - all review mutations flow through runtime commands and transactions
10
- - detached comments or revisions remain addressable with reason metadata; they are not silently dropped
11
- - v1 authoring is limited to single-paragraph comments, thread replies, tracked insertions, tracked deletions, and accept/reject flows
12
- - preserve-only review structures such as multi-paragraph editable comment ranges, unlinked move revisions, and unsupported structural list/table revisions stay locked and warning-backed
13
-
14
- Key subdirectories:
15
-
16
- - `store/`
@@ -1,3 +0,0 @@
1
- # Review Store
2
-
3
- Comment threads, revision records, review selectors, and accept/reject state belong here.
@@ -1,3 +0,0 @@
1
- # Runtime
2
-
3
- The document controller and coordination between canonical state, review state, UI state, preservation, validation, and IO belong here.
package/src/ui/README.md DELETED
@@ -1,30 +0,0 @@
1
- # UI
2
-
3
- This directory contains the public entry point and shared headless logic for the editor UI.
4
-
5
- ## Entry Point
6
-
7
- `WordReviewEditor.tsx` is the public component. It bridges the `DocumentRuntime` to the Tailwind rendering layer in `src/ui-tailwind/`.
8
-
9
- ## Headless Logic
10
-
11
- `headless/` contains pure, framework-free utilities shared across implementations:
12
-
13
- - `use-editor-keyboard.ts` — Keyboard event handler factory
14
- - `comment-decoration-model.ts` — Comment anchor → highlight class computation
15
- - `revision-decoration-model.ts` — Revision anchor → highlight class computation
16
- - `selection-helpers.ts` — Selection snapshot utilities
17
-
18
- ## Session Capabilities
19
-
20
- `src/runtime/session-capabilities.ts` derives all UI control states from `RuntimeRenderSnapshot`. The `deriveCapabilities(snapshot, reviewMode)` function is called on every render in `WordReviewEditor.tsx` and the result is passed to the workspace components.
21
-
22
- ## Shared Utilities
23
-
24
- `shared/revision-filters.ts` — Shared revision filtering and empty state helpers.
25
-
26
- ## Rendering
27
-
28
- All visual rendering is in `src/ui-tailwind/`. See `docs/reference/word-review-editor-frontend-architecture.md` for the canonical architecture.
29
-
30
- Legacy inline-CSSProperties components have been removed.
@@ -1,3 +0,0 @@
1
- # Comments UI
2
-
3
- Comment markers, thread navigation, and sidebar thread views belong here.
@@ -1,3 +0,0 @@
1
- # Compatibility UI
2
-
3
- Compatibility reports, preserve-only warnings, and unsupported-content summaries belong here.
@@ -1,3 +0,0 @@
1
- # Editor Surface
2
-
3
- The editable document canvas, overlays, and selection-aware rendering belong here.
@@ -1,3 +0,0 @@
1
- # Review UI
2
-
3
- Tracked-change display modes, review navigation, and accept/reject surfaces belong here.
@@ -1,3 +0,0 @@
1
- # Status UI
2
-
3
- Dirty state, autosave state, import/export progress, and validation status surfaces belong here.
@@ -1,3 +0,0 @@
1
- # Theme
2
-
3
- Design tokens, CSS variable mapping, and host-theme integration belong here.
@@ -1,3 +0,0 @@
1
- # Toolbar
2
-
3
- The compact command toolbar and contextual editor controls belong here.
@@ -1,22 +0,0 @@
1
- # Debug UX (internal only)
2
-
3
- Runtime debug chrome is not a production API surface. `WordReviewEditor` does
4
- not expose a `debugMode` prop, `api.ui.debug.attach()` is a hard-disabled
5
- runtime API call, and `ChromePosture.debugMode` is production-forced to
6
- `"off"`.
7
-
8
- The supported local diagnostic surface is the mounted runtime REPL keyboard
9
- shortcut. Open it with `Cmd/Ctrl+Alt+P`; its `Agent layer view` shares the
10
- L01-L11 layer map with the harness debug pane, including `Alt+1`...`Alt+9`,
11
- `Alt+0`, and `Alt+-` navigation plus snippets that evaluate against
12
- `runtime`/`ref`. These components remain in the tree for internal harness/story
13
- experiments only; do not wire them into `WordReviewEditor` or public API paths.
14
-
15
- ## Files
16
-
17
- | File | Purpose |
18
- |---|---|
19
- | `tw-debug-top-bar.tsx` | Internal minimal top bar for harness/story experiments |
20
- | `tw-debug-overlay.tsx` | Internal overlay rendering `DebugInspectorSnapshot` sections |
21
- | `tw-debug-repl.tsx` | Legacy placeholder; production diagnostics use `tw-runtime-repl-dialog.tsx` |
22
- | `tw-debug-event-tail.tsx` | Tail of the last N events on active telemetry channels |
@@ -1,3 +0,0 @@
1
- # Validation
2
-
3
- Compatibility checks, round-trip validation, support classification, and Word reopen evidence helpers belong here.