Velo Plot

Appearance

velo-plot Development Roadmap → v3.0.0 ​

Current version: 3.0.0
Last updated: 2026-07-10
Status: Stage 5 GA shipped — Stage 6 (SVG parity) next

This roadmap defines the path from velo-plot v1.12.0 to a v3.0.0 release that delivers an exponential leap in quality, performance, and developer experience — for both scientific visualization and financial/trading use cases.

The previous roadmap (ROADMAP-LEGACY.md) is archived (English historical catalog with reconciled status). It listed many features as "COMPLETED" that were stubs or partial. This document is grounded in a full codebase audit (July 2026).

GA status: v3.0.0 ships bundle size CI, ESLint gate, public type cleanup, known-limitations on API pages, ADRs 001–003, and documented security audit. Remaining release ops: npm latest tag + GitHub release assets.

Vision ​

velo-plot started as a high-performance WebGL scientific charting engine. Recent work (v1.12.0) added stacked multi-pane layouts, chart synchronization, candlesticks, and composite indicator panes — making it viable for trading dashboards (e.g. portfolio-fall).

v3.0.0 means:

  • No undocumented stubs in the public API
  • Measurable performance guarantees with reproducible benchmarks
  • Trading parity with professional chart libraries (sessions, drawing tools, replay, alerts)
  • Scientific depth retained and polished (forecasting, ML, LaTeX, 3D)
  • React DX on par with first-class chart libraries
  • CI that runs tests, lint, and build on every PR

How to read this roadmap ​

Each stage is a self-contained file with:

SectionPurpose
GoalWhat this stage achieves and target version range
Current stateWhat already exists (with source file references)
Work itemsPrioritized tasks with complexity and definition of done
RisksBreaking changes, dependencies, scope creep
Exit checklistObjective criteria before moving to the next stage

Stages can overlap in calendar time (e.g. scientific and trading work in parallel), but exit checklists must be satisfied before their version tags ship.

Stages overview ​

mermaid
flowchart LR
  subgraph v1x [v1.13 to v1.15]
    S0[Stage 0: Foundation Audit]
  end
  subgraph v1x_perf [v1.16 to v1.19]
    S1[Stage 1: Render Engine]
  end
  subgraph v2x [v2.0 to v2.1]
    S2[Stage 2: Trading Experience]
    S3[Stage 3: Scientific Depth]
  end
  subgraph v2x_dx [v2.2 to v2.9]
    S4[Stage 4: React and DX]
  end
  subgraph v3 [v3.0.0]
    S5[Stage 5: Stable Platform]
  end
  subgraph v4 [v3.1 to v4.0]
    S6[Stage 6: SVG Vector Parity]
  end
  S0 --> S1
  S1 --> S2
  S1 --> S3
  S2 --> S4
  S3 --> S4
  S4 --> S5
  S5 --> S6
StageFileVersion targetTheme
000-foundation-audit.mdv1.13.0 – v1.15.0Honest audit, CI, exports, core tests
101-render-engine-performance.mdv1.16.0 – v1.19.0WebGL/WebGPU, virtualization, workers
202-trading-experience.mdv2.0.0 – v2.1.0Market time scale, drawings, replay, alerts
303-scientific-depth.mdv2.1.0 – v2.2.0Forecasting, ML, LaTeX, 3D polish
404-react-dx-ecosystem.mdv2.2.0 – v2.9.0React components, a11y, touch, CLI
505-v3-stable-platform.mdv3.0.0Bundles, migration guide, release criteria
606-svg-vector-parity.mdv3.1.0 – v4.0.0Full SVG homolog of every v3 feature — zero skipped export

Stage 6 — SVG vector parity (summary) ​

After v3.0.0 freezes the canvas/WebGL feature set, Stage 6 builds a complete vector SVG homolog for every user-visible capability: all SeriesType values, overlays, indicators, plugins, stacked layouts, and (when shipped) trading/scientific overlays. Nothing stays raster-only without an explicit documented exception.

See the full parity matrix and exit checklist for v4.0.0.

Known gaps at v1.12.0 (audit summary) ​

These are the highest-impact issues driving Stage 0:

IssueLocationImpact
syncSelection not implementedsrc/core/sync/index.ts:327Multi-pane selection sync broken
PluginSync is a stubsrc/plugins/sync/index.tsPlugin API misleading
PluginForecasting throws on several methodssrc/plugins/forecasting/algorithms.ts:55Documented but non-functional
Custom pattern recognition not implementedsrc/plugins/pattern-recognition/patterns.ts:631API throws
WebGPU flag misleadingsrc/core/chart/ChartCore.ts:317Users enable unsupported renderer
./react export missingpackage.jsonREADME import path broken
Build/export misalignmentvite.config.lib.ts vs package.jsonSome subpaths may not build
~3.5% file test coverage11 test files / ~310 source filesRegressions likely
No CI test workflow.github/workflows/Quality not enforced

Versioning policy ​

  • Patch (x.y.Z): Bug fixes, no API changes
  • Minor (x.Y.z): New features, backward compatible
  • Major (X.y.z): Breaking API changes — expected at v2.0.0 (trading API) and v3.0.0 (bundle consolidation)

All releases require an updated CHANGELOG.md entry following Keep a Changelog.

Released under the MIT License.

Copyright © 2025-present Velo Plot