@beyondwork/docx-react-component 1.0.0

package/docs/plans/waves/wave-35.md

@@ -0,0 +1,141 @@
+# Wave 35 - Track Change Extensions
+
+**Commit message**: `Build: property change tracking, move revisions`
+
+## Project profile
+- project: React Word Editor
+- new-project: no
+- oversight-mode: dark-factory
+- lane: main
+
+## Sequencing note
+- Group E: Extends revision model for complete track changes.
+
+## Component promotions
+- track-change-extensions: baseline-proved
+
+## Context7 defaults
+- bundle: word-editor-testing
+- query: "OOXML track changes pPrChange sectPrChange tblPrChange moveTo moveFrom"
+
+## Agent A0: cont-QA
+### Role prompts
+- docs/agents/wave-cont-qa-role.md
+### Executor
+- profile: deep-review
+### Context7
+- bundle: none
+- query: "Architecture evaluation only"
+### Deliverables
+- docs/plans/waves/reviews/wave-35-cont-qa.md
+### Prompt
+```text
+Primary goal: Verify revision extensions work and existing tests pass.
+Required context: docs/reference/repository-guidance.md, docs/research/agent-context-sources.md
+File ownership (only touch these paths):
+- docs/plans/waves/reviews/wave-35-cont-qa.md
+```
+
+## Agent A8: Integration Steward
+### Role prompts
+- docs/agents/wave-integration-role.md
+### Executor
+- profile: deep-review
+### Context7
+- bundle: none
+- query: "Integration synthesis only"
+### Capabilities
+- integration
+- docs-shared-plan
+### Deliverables
+- .tmp/main-wave-launcher/integration/wave-35.md
+- .tmp/main-wave-launcher/integration/wave-35.json
+### Prompt
+```text
+Primary goal: Verify revision extensions integrate with existing review system.
+Required context: docs/reference/repository-guidance.md, docs/research/agent-context-sources.md, docs/plans/current-state.md
+File ownership (only touch these paths):
+- .tmp/main-wave-launcher/integration/wave-35.md
+- .tmp/main-wave-launcher/integration/wave-35.json
+```
+
+## Agent A9: Documentation Steward
+### Role prompts
+- docs/agents/wave-documentation-role.md
+### Executor
+- profile: docs-pass
+### Context7
+- bundle: none
+- query: "Shared plan documentation only"
+### Deliverables
+- docs/roadmap.md
+- docs/plans/current-state.md
+- docs/plans/master-plan.md
+- docs/plans/migration.md
+- docs/plans/component-cutover-matrix.md
+- docs/plans/component-cutover-matrix.json
+### Prompt
+```text
+Primary goal: Update shared plan docs.
+Required context: docs/reference/repository-guidance.md, docs/research/agent-context-sources.md, docs/plans/current-state.md
+File ownership (only touch these paths):
+- docs/roadmap.md
+- docs/plans/current-state.md
+- docs/plans/master-plan.md
+- docs/plans/migration.md
+- docs/plans/component-cutover-matrix.md
+- docs/plans/component-cutover-matrix.json
+```
+
+## Agent A1: Property Changes And Move Tracking
+### Executor
+- profile: implement-claude
+### Context7
+- bundle: word-editor-testing
+- query: "OOXML w:pPrChange w:sectPrChange w:tblPrChange w:moveTo w:moveFrom revision model accept reject"
+### Components
+- track-change-extensions
+### Deliverables
+- src/io/ooxml/parse-revisions.ts
+- src/io/export/serialize-revisions.ts
+- src/review/store/revision-types.ts
+- src/review/store/revision-store.ts
+- src/model/canonical-document.ts
+- test/review/property-change-revisions.test.ts
+- test/review/move-revisions.test.ts
+- .tmp/wave-35-track-proof/revisions.json
+### Proof artifacts
+- path: .tmp/wave-35-track-proof/revisions.json | kind: proof-bundle | required-for: baseline-proved
+### Exit contract
+- completion: authoritative
+- durability: durable
+- proof: integration
+- doc-impact: none
+### Prompt
+```text
+Primary goal: Parse property change revisions and move tracking.
+
+Required context:
+- docs/reference/repository-guidance.md
+- docs/research/agent-context-sources.md
+- docs/architecture/ooxml-upgrade-analysis.md
+- src/io/ooxml/parse-revisions.ts, src/review/store/revision-types.ts
+
+File ownership (only touch these paths):
+- src/io/ooxml/parse-revisions.ts
+- src/io/export/serialize-revisions.ts
+- src/review/store/revision-types.ts
+- src/review/store/revision-store.ts
+- src/model/canonical-document.ts
+- test/review/property-change-revisions.test.ts
+- test/review/move-revisions.test.ts
+- .tmp/wave-35-track-proof/revisions.json
+
+Requirements:
+1) Parse w:pPrChange, w:sectPrChange, w:tblPrChange with old/new property pairs.
+2) Parse w:moveTo/w:moveFrom with linked move IDs.
+3) PropertyChangeRevision and MoveRevision types.
+4) Accept/reject logic for property changes and moves.
+5) Serialize all back to OOXML.
+6) Round-trip tests. CRITICAL: Do not break existing revision tests.
+```

package/docs/plans/waves/wave-36.md

@@ -0,0 +1,146 @@
+# Wave 36 - Complex Content Read-Only Rendering
+
+**Commit message**: `Build: read-only preview for charts, shapes, SmartArt, WordArt, VML`
+
+## Project profile
+- project: React Word Editor
+- new-project: no
+- oversight-mode: dark-factory
+- lane: main
+
+## Sequencing note
+- Group F: Read-only fallback rendering using preview images. No editing. Preserve on export.
+
+## Component promotions
+- complex-rendering: baseline-proved
+
+## Context7 defaults
+- bundle: word-editor-testing
+- query: "OOXML charts SmartArt shapes WordArt VML fallback rendering EMF preview"
+
+## Agent A0: cont-QA
+### Role prompts
+- docs/agents/wave-cont-qa-role.md
+### Executor
+- profile: deep-review
+### Context7
+- bundle: none
+- query: "Architecture evaluation only"
+### Deliverables
+- docs/plans/waves/reviews/wave-36-cont-qa.md
+### Prompt
+```text
+Primary goal: Verify complex content renders and round-trips correctly.
+Required context: docs/reference/repository-guidance.md, docs/research/agent-context-sources.md
+File ownership (only touch these paths):
+- docs/plans/waves/reviews/wave-36-cont-qa.md
+```
+
+## Agent A8: Integration Steward
+### Role prompts
+- docs/agents/wave-integration-role.md
+### Executor
+- profile: deep-review
+### Context7
+- bundle: none
+- query: "Integration synthesis only"
+### Capabilities
+- integration
+- docs-shared-plan
+### Deliverables
+- .tmp/main-wave-launcher/integration/wave-36.md
+- .tmp/main-wave-launcher/integration/wave-36.json
+### Prompt
+```text
+Primary goal: Verify complex content preserves correctly through export.
+Required context: docs/reference/repository-guidance.md, docs/research/agent-context-sources.md, docs/plans/current-state.md
+File ownership (only touch these paths):
+- .tmp/main-wave-launcher/integration/wave-36.md
+- .tmp/main-wave-launcher/integration/wave-36.json
+```
+
+## Agent A9: Documentation Steward
+### Role prompts
+- docs/agents/wave-documentation-role.md
+### Executor
+- profile: docs-pass
+### Context7
+- bundle: none
+- query: "Shared plan documentation only"
+### Deliverables
+- docs/roadmap.md
+- docs/plans/current-state.md
+- docs/plans/master-plan.md
+- docs/plans/migration.md
+- docs/plans/component-cutover-matrix.md
+- docs/plans/component-cutover-matrix.json
+### Prompt
+```text
+Primary goal: Update shared plan docs for complex content rendering.
+Required context: docs/reference/repository-guidance.md, docs/research/agent-context-sources.md, docs/plans/current-state.md
+File ownership (only touch these paths):
+- docs/roadmap.md
+- docs/plans/current-state.md
+- docs/plans/master-plan.md
+- docs/plans/migration.md
+- docs/plans/component-cutover-matrix.md
+- docs/plans/component-cutover-matrix.json
+```
+
+## Agent A1: Charts, SmartArt, Shapes, WordArt, VML Preview
+### Executor
+- profile: implement-claude
+### Context7
+- bundle: word-editor-testing
+- query: "OOXML c:chart dgm:* wps:wsp VML mc:AlternateContent fallback EMF PNG preview rendering"
+### Components
+- complex-rendering
+### Deliverables
+- src/io/ooxml/parse-complex-content.ts
+- src/io/ooxml/parse-shapes.ts
+- src/model/canonical-document.ts
+- src/runtime/surface-projection.ts
+- src/ui-tailwind/editor-surface/pm-schema.ts
+- src/ui-tailwind/editor-surface/pm-state-from-snapshot.ts
+- test/io/complex-content-roundtrip.test.ts
+- .tmp/wave-36-complex-proof/all-complex.json
+### Proof artifacts
+- path: .tmp/wave-36-complex-proof/all-complex.json | kind: proof-bundle | required-for: baseline-proved
+### Exit contract
+- completion: authoritative
+- durability: durable
+- proof: integration
+- doc-impact: none
+### Prompt
+```text
+Primary goal: Render charts, SmartArt, shapes, WordArt, and VML as read-only previews.
+
+Required context:
+- docs/reference/repository-guidance.md
+- docs/research/agent-context-sources.md
+- docs/architecture/ooxml-upgrade-analysis.md
+- src/preservation/ for opaque content patterns
+- src/io/ooxml/parse-inline-media.ts for DrawingML patterns
+
+File ownership (only touch these paths):
+- src/io/ooxml/parse-complex-content.ts
+- src/io/ooxml/parse-shapes.ts
+- src/model/canonical-document.ts
+- src/runtime/surface-projection.ts
+- src/ui-tailwind/editor-surface/pm-schema.ts
+- src/ui-tailwind/editor-surface/pm-state-from-snapshot.ts
+- test/io/complex-content-roundtrip.test.ts
+- .tmp/wave-36-complex-proof/all-complex.json
+
+Requirements:
+1) Charts: Extract fallback image from mc:AlternateContent. ChartPreviewNode with preview image.
+2) SmartArt: Same pattern. SmartArtPreviewNode.
+3) Shapes (wps:wsp): Parse basic geometry and text. Render as bordered div with text content.
+4) WordArt: Render text with styled label.
+5) VML (v:*): Parse v:shape, v:rect, v:textbox. Extract text for display.
+6) All: Preserve original XML for round-trip via preservation system.
+7) PM schema: atom nodes (not editable). Surface projection: read-only labeled blocks.
+8) Export: reattach original parts untouched.
+9) Round-trip tests for all types.
+10) CRITICAL: Do not break existing tests or preservation.
+```

package/docs/plans/xlsx/README.md

@@ -0,0 +1,14 @@
+# Xlsx Plans
+
+This directory holds canonical planned docs for the future xlsx runtime.
+
+Current canonical docs here:
+
+- `xlsx-fixture-corpus-and-certification-plan.md`
+
+Related planned xlsx docs live in:
+
+- `docs/architecture/xlsx/`
+- `docs/reference/xlsx/`
+
+The research intake for those plans remains under `docs/xlsx-react/`.

package/docs/plans/xlsx/xlsx-fixture-corpus-and-certification-plan.md

@@ -0,0 +1,126 @@
+# XLSX Fixture Corpus And Certification Plan
+
+## Status
+
+- Planned fixture and certification program for the future `xlsx` runtime.
+- Not a current shipped test program in this repo.
+- Intended to give the xlsx work the same proof-first discipline as the active docx track.
+
+## Purpose
+
+The xlsx runtime should not claim compatibility based on parser or serializer confidence alone.
+
+Its permanent proof program should answer four questions:
+
+1. can the runtime import the package safely
+2. can it edit the declared supported slice safely
+3. can it export a structurally valid package
+4. can Excel reopen that export without repair prompts
+
+## Corpus Split
+
+The fixture program should be split into two groups:
+
+### Release-Gate Fixtures
+
+Small, deterministic fixtures that block promotion of supported features.
+
+These should cover:
+
+- minimal workbook structure
+- core cell value and type cases
+- shared strings and inline strings
+- formulas and reference remapping
+- merges
+- styles subset
+- sheet reorder and rename
+- basic notes or annotation surfaces if supported
+- preserve-only unknown parts and relationships
+- malformed or unsupported-fatal inputs
+
+### Representative Scenarios
+
+Larger real-world workbooks used for confidence, certification, and operator review.
+
+These should include:
+
+- Excel-authored workbooks
+- cross-origin exports such as Google Sheets or LibreOffice
+- style-heavy business reports
+- formula-heavy operational sheets
+- preserve-only workbook features such as charts, pivots, threaded comments, or advanced extensions
+
+## Required Proof Layers
+
+Every supported xlsx feature should eventually pass:
+
+1. package integrity checks
+2. import and normalization tests
+3. runtime edit tests
+4. export and re-import tests
+5. validator-service checks
+6. Excel desktop reopen notes
+7. Excel web reopen notes for representative flows
+
+## Preservation Proof
+
+Preserve-only workbook surfaces must have explicit proof too.
+
+Minimum preservation assertions:
+
+- unknown parts are retained
+- unknown relationships stay reachable and valid
+- extension markup required for host fidelity is not silently dropped
+- unrelated supported edits do not damage preserve-only workbook features
+
+## Host Matrix
+
+The intended certification host matrix should include:
+
+- Excel Desktop on Windows
+- Excel Desktop on macOS
+- Excel for the web
+
+Optional later expansion can include older perpetual Excel releases if product needs demand it.
+
+## Example Fixture Categories
+
+- minimal workbook
+- mixed cell types
+- cross-sheet formulas
+- merges
+- style-heavy workbook
+- notes or legacy comment coverage
+- threaded comment preserve-only case
+- table preserve-only case
+- drawing or chart preserve-only case
+- hostile cross-origin workbook
+- malformed package fail-closed case
+
+## Promotion Rule
+
+The future xlsx runtime should use the same honesty rule as the active docx program:
+
+- no component or feature becomes `supported-roundtrip` from helper-level tests alone
+- no preserve-only surface is silently upgraded by narrative confidence
+- promotions require fixture-backed proof and host reopen evidence
+
+## Relationship To The Active Docx Program
+
+This planned xlsx proof program is modeled on the current docx fixture discipline, but it does not inherit the active docx wave maturity line.
+
+That means:
+
+- docx fixtures and wave evidence remain the only shipped proof program today
+- xlsx needs its own corpus, validators, and certification evidence
+- shared platform work can be reused, but supported feature claims must be re-earned for xlsx
+
+## Source Research Mapping
+
+This canonical doc is derived from:
+
+- `docs/xlsx-react/xlsx-fixture-corpus-and-certification-plan.md`
+- `docs/xlsx-react/xlsx-ooxml-compliance.md`
+- `docs/xlsx-react/shared-openxml-editor-platform-docx-xlsx.md`
+
+The research paper remains useful background, but this file is the repo-aligned planned certification reference.