0.25.x¶

0.25.0¶

Mermaid diagram rendering in the RST preview

The RST preview panel now renders .. mermaid:: directives as live diagrams, building on the image and figure rendering introduced in 0.23.0. Rendering is highly responsive — diagrams update instantly as you type, without flickering or disappearing while you edit other parts of the document. Diagrams also adapt automatically to your VS Code color theme.

As with image preview, this feature requires ubcode.preview.experimentalRendering to be enabled in your VS Code settings (or toggled via the preview toolbar button).

Caution

External file references (e.g. .. mermaid:: path/to/file.mmd) are not yet supported; only inline diagram source is rendered. External file support is intended for a future improvement.

Significantly reduced needs index size

The needs index now deduplicates field values that match their schema defaults, dramatically shrinking cached index files and speeding up load times. As a reference point, a project with ~40,000 needs and ~120 custom fields sees its cached index shrink from 109 MB to 31 MB and loads ~5x faster.

This means noticeably faster startup for VS Code features that depend on the index — particularly the Needs Index tree view and the Need graph view — as well as faster incremental builds, CLI commands, and MCP queries.