Roadmap

April 23, 2026 · View on GitHub

This file provides an overview of the direction this project is heading. It contains both likely and more aspirational changes. For more granular improvements, see the project’s issues backlog.

Planned

Specific, well-scoped changes that have concrete time-bound implementation plans.

Ready

Feasible, near-term improvement ideas that are clear in scope.

Performance regression baselines in CI

Add representative content fixtures and record make benchmark + memray stats per PR to fail builds on slowdowns in string, lxml, and html5lib engines.

Configuration cookbook and compatibility matrix

Expand docs with end-to-end samples for Django/Wagtail and pure Python usage, plus tables covering supported Python versions, optional parser versions, and Draft.js releases.

Release and maintenance automation

Add a tagged-release workflow that builds with uv, publishes to PyPI, updates CHANGELOG, and generates SBOMs; surface renovate rules and dependency review dashboards.

AI-assisted configuration starter kit

Provide a cookbook showing how to prompt LLMs to draft block maps/entity decorators from HTML samples, and scripts to turn that output into typed configs and fixtures.

Experimental

Possible changes that require R&D, and high-risk ideas that could bring large benefits but with likely trade-offs.

Rust-backed DOM engine

Prototype a Rust extension or PyO3 module for DOM construction to outperform the current string/lxml/html5lib engines on large documents.

Streaming and async export

Explore a streaming API that yields HTML incrementally (sync/async) to reduce memory for very long ContentState exports.

Python 3.12+ only refactor

After dropping 3.10/3.11, adopt 3.12+ features (faster f-strings, typing.Self/TypeAliasType, better match exhaustiveness) to simplify Options/State internals and improve runtime speed.

Backlog

Likely useful but lower-priority or “filler” tasks.