@beyondwork/docx-react-component 1.0.0 → 1.0.2

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

@@ -1,141 +0,0 @@
-# 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

@@ -1,146 +0,0 @@
-# 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

@@ -1,14 +0,0 @@
-# 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

@@ -1,126 +0,0 @@
-# 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.