Browse docs
Historical @vuer-ai/vuer-viz comparison
Scope correction — 2026-11-16: this audit inspected @vuer-ai/vuer-viz, not @vuer-ai/vizkit. It is retained as a historical comparison of the explicitly named package. It does not establish an alias or describe the requested Vizkit API. See the current two-site API comparison. Subsequent source review corrected this historical table's halo color, exported provider-hook names, and generic-range wording; those were factual errors, not version differences.
Checked on 2026-11-09, after the parallel-coordinate curves and axis-mode additions. These libraries share visualization ideas, but their components are not drop-in replacements. This comparison distinguishes intentional product choices, missing capabilities, and documentation inconsistencies.
Versions and sources
At the 2026-11-09 observation, the Vuer live docs displayed 1.2.14. Its published package records source revision a7a329b11f4c57d855c61079b82ed8a6924acb8e. We inspected the declarations and embedded source map in that exact tarball, plus the live examples. Registry latest at that observation was 1.2.15, revision 4518c5caa524b8a83a414494964397e497059595; its parallel implementation and declarations match 1.2.14. Changes include formatters, bar rendering and series tooltip behavior, so the table below uses 1.2.14, not an assumption that the website runs latest.
DreamLake live docs initially displayed 0.28.7, source revision c81d42a (PR 158). The DreamLake column describes the implementation shipped with this page: see the site's version badge and versioned source. The previous 0.28.6 interaction release is PR 157. New curve/mode APIs below require 0.29.0. 0.31.4 update (2026-11-16): straight connectors are now the default and hover emphasis has no fade; curve="smooth" remains available. The Vuer audit below retains its original observation date. The release handoff binds the exact merged commit, npm integrity and deployed revision; a package version is not inferred solely from a live site's badge.
Primary source indexes: Vuer exports, Vuer common types, Vuer embedded implementation, DreamLake public exports, DreamLake package exports. Source inspection supports behavioral claims; this is not a performance comparison between the two libraries.
Parallel coordinates first
Sources: Vuer examples, Vuer props, Vuer store, DreamLake examples and props, DreamLake types and model.
| Area | Vuer 1.2.14 | DreamLake 0.31.4 | Assessment / migration |
|---|---|---|---|
| Component and data | ParallelAxis, dimensions, each series has an ordered values array | ParallelCoordinates, axes with stable id and label; values keyed by axis ID | Intentional identity contract. Assign durable record and axis IDs before conversion; labels need not be unique. |
| Numeric limits | Dimension min / max; implicit numeric string parsing | domain: [min,max]; auto nice-number bounds; raw strings remain strings unless numericValue is supplied | Intentional exact-data contract. Convert limits explicitly; do not silently parse research data. |
| Categories | String categories; click-generated lists truncated to 10; unsupported category normalizes to bottom | String and numeric categories remain distinct; ordered arrays or functions; unknown values create gaps | Intentional missing-data behavior. No equivalent 10-category cap; readability still limits dense categorical axes. |
| Curves | Catmull–Rom style cubic interpolation for 3+ points; straight segment for two | Straight segments by default; curve="smooth" opts into bounded cubic connectors, including two axes | Intentional: exact endpoints and no overshoot beyond each segment's values. Curves are visual connectors, not inferred measurements. |
| Width and halo | Per-series lineWidth, opacity, lineStyle; normal default 3; actual highlight default 1.3×; currentColor understroke +3 | lineWidth=2 plus series.width; active default base × 1.65, halo default active +4; theme-aware or activeHaloColor | Missing parity: per-series dash/opacity controls. Theme-aware halo is a DreamLake addition. |
| Layout | Fixed 325×220 default; internal 60px side insets, larger right legend inset; axisSpacing | Measures parent width; independent paddingLeft=0, paddingRight=0; minAxisSpacing=0 fills width, opt-in scrolling; plot height 290 | Intentional responsive default. axisSpacing is not a direct rename: DreamLake's setting is a minimum. |
| Labels/readouts | Axis labels below; hoverLayout auto resolves above; numeric hover rounds to two decimals | labelPlacement above/below; hoverLayout auto chooses opposite side; raw formatted value at every axis plus full textual explanation | Same placement vocabulary, different auto rule. Specify placement explicitly for visual parity. |
| Selection | selectedIndices, callback indices, multiSelect; onHover(index or null) | Controlled selectedIds, callback IDs; keyboard row controls; no public hover callback or single-select prop | Intentional IDs; hover callback is a remaining capability gap. Single selection can be implemented in the host callback. |
| Axis changes | Label/line click toggles type; Jotai atom persisted in localStorage, keyed by display name | Native label dialog; component-local defaults or controlled axisModes / onAxisModesChange; no implicit persistence | Intentional isolation. Controlled modes without callback are read-only. Hosts can persist a serializable subset by stable ID. |
| Modes and functions | Store exposes vtype, low, high, categories; no parallel log/custom-transform prop | Numeric/category, linear/log/custom transform+inverse+ticks, exact/auto/uniform/function domain, category/accessor functions | DreamLake additions. Functions run in geometry and ticks, not just notifications; persist strategy IDs rather than serializing functions. |
| Invalid/missing values | Public values type excludes null; numeric parse and fallback positioning in implementation | Null/nonfinite/nonnumeric/unknown/out-of-domain values leave gaps; nonpositive log values reported; raw hover remains visible | Intentional stricter semantics. Selection uses the same configured paths as rendering. Neither API declares an axis range brush or reorder callback. |
| Legend/overlays | legend, layout, children slots | Keyboard-selectable run list, active values; no arbitrary overlay slot | Missing compositional parity, not a renamed prop. Do not pass Vuer children and expect them to render. |
Data and state migration
Use IDs from the dataset. Array indices below are used only to look up legacy positional values, never as persisted selection identity.
Prefer migrating the surrounding table to stable selected IDs too. Rebuild index mappings after filtering/reordering. For host-enforced single selection, select the newly added ID or clear when the selected row is toggled off.
The runnable modes example includes category ordering and an explicit numeric-text accessor. Custom transforms must be finite and strictly increasing over the displayed domain, with a matching inverse; invalid strategies display an unavailable axis rather than fabricated positions.
Remaining overlapping surface
| Surface | Vuer API / live documentation | DreamLake API / live documentation | Intentional difference or follow-up |
|---|---|---|---|
| Lines and bands | LineChart, LineSeries: flat x, y, optional low/high, lineWidth, lineStyle, showPoints | EpisodeLineChart: stable series id, nested data: {x,y,low,high}, required color, width, dash, formatValue | Nest arrays and add IDs/color. Preserve original samples. Point markers remain a gap; both now use non-scaling CSS-pixel widths. |
| Numeric axes | xMin/xMax/yMin/yMax, xFormat/yFormat, formatter-name or tick/label function | xAxis, yRange, formatTick, numeric helpers; time axes separate | Intentional time/numeric distinction. Map bounds explicitly. Vuer formatters are not interchangeable with a value-to-string formatter. Parallel custom ticks use raw values with its transform. |
| Cursor and events | onChange(ChartChangeEvent), VerticalMarker, SeriesTooltip children; event includes bounds/type/nearest point | time, onHover, onHoverEnd, onSeek, isScrubOwner; integrated portaled readout, nearest recorded samples | Intentional shared-playhead ownership. Map hover to preview and click to commit; don't set a permanent selection on every pointer move. |
| Dense rendering | canvas opt-in | rendering="auto" / "exact", visible-window culling and extrema-preserving SVG display reduction | Different renderer contract. Both need workload-specific measurements; no claim of cross-library benchmark superiority. |
| Zoom, marks, intervals | useZoom, usePan, useZoomPan, overlays and marker/custom-range overlays | zoom / panPct / onViewportChange, markers/ranges props; EpisodeTimeline for tracks | Explicit adapter needed. General child overlays and episode tracks have different lifecycles and coordinate contracts. |
| Image | Image: fit/position/caption/loading/error callbacks | ImageView / ImagePreview: image/file-preview composition, resolution callback | Partial overlap. No direct fit/position prop on ImageView. Its onLoad returns a resolution string, not Vuer's zero-argument event. |
| Video | Video: src/sources, controlled time, scrub/play events, snapshot function; glob needs server support | EpisodeVideoStack, EpisodeFrameStack, VideoView/preview | Intentional synchronized multi-camera and frame model. Map sources to stable video IDs and share time/duration; simple native preview is not a controlled video replacement. |
| Text / README / ANSI | Text, README, ANSI | TextView, TextPreview and file loading | Map content to text and loading ownership explicitly. DreamLake adds edit/save but has no matching public Markdown/ANSI renderer, TOC or syntax-theme contract. |
| Bars and heatmaps | BarChart; Heatmap types exported | No public generic BarChart/Heatmap equivalent in inspected exports | Missing DreamLake surface. Dataset table/image views are not equivalent. Prioritize only when an actual consumer needs them. |
| Layout/theme | BaseChartProps, ChartLayout, axes/grid/legend primitives; numeric fixed dimensions, matplotlib typography | Parent layout, compact sizes, transparent chart defaults; host Tailwind v4 source scanning and data-theme; composed media may have surfaces | Intentional UIKit embedding. Do not introduce a filled chart background to mimic another theme. Generic ChartLayout/primitive parity is absent. |
| Data acquisition | useSeriesData, useTabularData, useSweepData, useGlobData, providers | StorageSchema sources/panels, Dataset adapters and .dreamrc, file loaders | Different abstraction boundaries. Query aggregation functions and format-specific recording readers need explicit adapters; no automatic one-to-one migration. |
| Imports | Root package exposes chart primitives, hooks and formatters; bundled ESM declarations | Root plus documented parallel-coordinates, episode/file/media subpaths; dataset/schema APIs via subpaths; shipped CSS/source for Tailwind | Use public exports, not copied internal paths. EpisodeFrameStack is root-exported but has no dedicated package subpath: document this asymmetry. |
Example line conversion: data: {x: old.x, y: old.y, low: old.low, high: old.high}; supply a stable id and color. Set duration, and for non-time x coordinates use xAxis={{kind: "numeric", label: "step"}}; translate the desired visible x bounds through zoom and panPct. Translate lineStyle names into SVG dash arrays before assigning dash. Keep the arrays sorted and finite in x, as the DreamLake lookup contract requires.
Inconsistencies and recommended follow-up
- Vuer docs/source drift: the homepage's first example passes
data: [{x,y}], while published LineSeries and the line-chart page use flatx/yarrays. Use the published type when migrating. The parallel highlight comment says 3× while implementation uses 1.3×. Parallel inheritsmargin/paddingfrom BaseChartProps but its implementation calculates internal margins without reading those props. These are reference inconsistencies, not contracts to reproduce. - Vuer inventory drift: live Visual Grammar lists omit Heatmap from its displayed ChartType and retain placeholder example sections; the published type includes heatmap but omits parallel. Its displayed font-size constant is 12 while the exact package defines 18. The observed site badge (1.2.14) trailed the then-latest registry version (1.2.15). Recommend generated declaration snippets and version-bound example compilation.
- DreamLake naming consistency: both parallel and episode charts share chart-level
lineWidth/activeLineWidthand per-serieswidthsince 0.28.7. Domain modes versus episodeyRange/formatTickstill need explicit mappings. Parallel selection is ID-based while episode cursors are numeric coordinates; this state distinction is intentional. Document those differences in a common API guide before considering compatible aliases. - Useful gaps: public parallel hover callback, per-series dash/opacity, arbitrary overlays, and generic bar/heatmap components have no direct DreamLake equivalent. Order follow-ups by concrete consuming workflows. Axis dragging/range brushing is not part of this release; add a deliberate controlled range model if needed.
- Evidence limits: 29 live pages were captured, all chart declaration groups and root/subpath exports inspected, and 1.2.14/1.2.15 embedded sources compared. The audit does not certify every hook's runtime, remote loading backend, or every browser engine. The parallel release has Chromium pointer, keyboard, touch, reduced-motion, theme and controlled/custom-mode evidence; document that separately from API parity.