Skip to content

ODP: add editable presentation import/export with guarded preservation - #895

Draft
NickBevers wants to merge 1 commit into
storytold:mainfrom
NickBevers:feat/odp-support
Draft

NickBevers wants to merge 1 commit into
storytold:mainfrom
NickBevers:feat/odp-support

Conversation

@NickBevers

@NickBevers NickBevers commented Oct 16, 2026 •

Copy link
Copy Markdown

Opening an OpenDocument presentation currently has no supported editable ODP workflow on this base. This change adds a separate deckcraft-odp crate and connects conversion, editing, export and exact original-source recovery to the desktop, web, CLI and MCP workflows.

This is a draft for architecture and scope feedback. The implementation supports the catalog in docs/odp-support.md and docs/table-data.md; complete ODF/OpenFormula conformance and exact PowerPoint appearance remain open.

Implemented

  • Editable ODP text, lists, shapes, media, tables, charts, shared master artwork, notes and supported timing, with warnings and retained source data for unrepresented semantics.
  • Exact typed cell values, versioned decimal formulas/functions/ranges, deterministic number formats, ordered nested tables and checked structural/reference edits, with command/UI editors and atomic undo.
  • Structured notes pages/master resources and editable PPTX projections with verified bounded native metadata, including unused notes and handout layouts.
  • Advanced comments with identities, replies, statuses, rich bodies/ranges, tasks and bounded file attachments; supported native/ODP/PPTX persistence and dependency-aware transfer.
  • A bounded source-preserving route for supported plain slide-text edits, exact original-package recovery, and refusal before writing when dependencies or semantics cannot be preserved.
  • Regression coverage for malformed/deep input, stale projection authority, actual editing and reopen workflows, resource identities, rendering and UI behavior. Fixtures are contributor-original synthetic data.

Remaining work before broader interoperability claims

  • Resolve the remaining edited-source/cache properties; arbitrary source-preserving edits remain incomplete.
  • Extend advanced formatting, live placeholder/style inheritance and template application; exact external font/layout fidelity remains unproven.
  • Add structured-notes comparison and broader source/dependency transfer support.
  • Extend complex timing graphs, transformed motion and external repeated-trigger playback.
  • Support additional functions/settings and arbitrary extension/application-object preservation outside the documented profiles.

Related work and integration

Existing ODP work is open in #524, #527 and #529 (import), and #568, #576 and #581 (export). This proposal uses a separate ODP crate and broader model/engine contracts. It does not assume that it should replace those PRs; feedback on architectural alignment and splitting this branch into reviewable dependent PRs would be useful.

  • Resolve the merge conflicts GitHub currently reports against main (the locally validated base is 9859da3; upstream had 15 additional commits when checked).
  • Agree on integration with the existing ODP PRs and the first mergeable scope.
  • Run upstream Linux CI on the published branch and resolve integration feedback.
  • Mark ready for review only when the agreed scope is ready.

Validation

  • Local macOS cargo xtask ci: all seven gates passed (formatting, PDF dependencies, Clippy with warnings denied, workspace tests, asset attribution, layering and WASM).
  • 3,249 unique tests passed; zero failed; nine ignored. The raw harness reports 3,250 passes because one FIFO subprocess test appears twice.
  • 306 XML schema checks passed against original ODF/OOXML schemas and contributor-original extension schemas. ODF foreign number-format attributes use the extended-document validation rule. Another 37 XML parts received namespace checks only.
  • Independent source review and synthetic UI/render inspection completed; 716 frozen Rust/config/schema hashes remained unchanged after validation.
  • This validation applies to the current implementation snapshot; project-wide README, roadmap, architecture/parity and attribution documents remain unchanged.

The change contains implementation, tests and dedicated feature documentation. Private source documents/screenshots, TEMP_ODP_PLAN.md, local planning files and temporary QA/build outputs are excluded.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs decision Needs a product or scope decision by a maintainer plugin candidate A good idea that is too specific or too big for the core

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants