Browse docs
Visualization API comparison
This compares the components documented at viz.vuer.ai and viz.dreamlake.ai, starting with parallel coordinates. The actual packages are @vuer-ai/vuer-viz and @dreamlake/viz. Similar chart names do not make their props, data, state, or callbacks interchangeable.
The separately requested package name @vuer-ai/vizkit has not been established as an alias: its exact public registry and CDN lookups returned 404 on 2026-11-16. This site-based comparison does not substitute an invented package identity. The November 9 audit remains available with its historical scope and subsequent factual corrections.
Versions and evidence
A direct Chromium capture on 2026-11-16 loaded all 30 Vuer documentation routes. Their rendered header reported 1.2.15, source 8a8b988. The npm 1.2.15 artifact records 4518c5c. The site imports library source; its only library differences from that published revision are three corrected type comments, not runtime or type-shape changes. The public declarations and embedded implementation provide inspectable evidence without repository access.
DreamLake's observed browser baseline was 0.31.4 / c431657.
The DreamLake column describes 0.32.3, including the 2026-11-17 parallel interaction corrections. Every trace now stays fully opaque during idle, hover, focus and selection. The experiment list uses UIKit virtualization and the shared selection controller from DreamLake's Experiments list. Direct axis/label mode cycling and the original Vuer Catmull–Rom formula with tension 0.5 remain in place; straight lines remain available. The release builds on 0.32.2 / dc94d710 and uses UIKit 0.2.11. The 0.32.3 source snapshot and parallel documentation describe the updated contracts. The November 17 correction checks these changed interactions; it does not claim a new full-site crawl.
A direct DreamLake browser capture also loaded 33 documentation routes at the baseline revision with HTTP 200 and no observed page errors. This is a source, declaration, example, and interaction audit. DreamLake's hover benchmarks compare its own revisions; they are not a performance ranking against Vuer-Viz. HTTP 200 alone is not evidence that a page hydrates or that every remote data provider works.
Parallel coordinates
Primary contracts: Vuer props, exported state, live examples, DreamLake props and examples, and DreamLake model.
| Contract | Vuer-Viz 1.2.15 | DreamLake 0.32.3 | Assessment / migration |
|---|---|---|---|
| Data and identity | ParallelAxis; 2–10 dimensions with name and type; each record has a positional values array. | ParallelCoordinates; axes and series have stable IDs; observations are keyed by axis ID. | Intentional identity contract. Supply durable IDs; duplicate display labels are allowed. Validate array lengths before conversion. |
| Numeric observations | Numeric strings are parsed with parseFloat; logical OR fallbacks use a minimum of 0 and maximum of 1. | Strings remain raw unless an explicit numericValue accessor supplies numeric positions. Valid explicit domains stay exact. | Intentional strictness. Vuer’s explicit maximum 0 becoming 1 is an implementation inconsistency, not behavior to copy. |
| Ticks and labels | Five evenly spaced fractions of each numeric domain, labels fixed to one decimal; no parallel tick-formatter prop. | Shared 1–2–5 numeric steps, value-based tick placement, exact explicit domains, custom scale ticks and formatValue. | Different contracts. Numeric-axis invariants apply to geometry and labels; formatting never changes recorded values. Vuer line formatters do not configure parallel ticks. |
| Categories and gaps | String categories; observations coerced with String(value). Unknown values go to the bottom. Caller lists over 10 warn but render; click-generated lists truncate to 10. | String and numeric categories remain distinct; unknown/missing/nonfinite/out-of-domain values leave gaps and retain explanatory readouts. | Intentional missing-data semantics. Decide explicitly how legacy coercion should migrate; never replace gaps with fabricated observations. |
| Connector geometry | Straight for two axes; Catmull–Rom-style cubic interpolation for three or more. No public curve selector. | Original Vuer Catmull–Rom formula, tension 0.5, by default; curve="linear" is explicit. Exact axis positions; missing values split connected runs. | For the same connected screen points, smooth geometry matches Vuer. Curves may overshoot between axes; connectors are not additional samples. |
| Pointer targets and motion | Hover/click distance is measured against straight point segments even when cubic curves are drawn; 10px threshold. Inline opacity/width transitions last 50ms. | Pointer targets use the rendered path. Stable base traces and separate emphasis layers avoid hover reordering; all traces stay fully opaque; width/halo emphasis has no fade. | Vuer's painted curve and hit target can diverge. This is an implementation limitation, not evidence of comparative benchmark speed. |
| Width, dash, opacity, halo | Normal width 3; active default 1.3×. Zero width falls back through logical OR. Per-series lineStyle and opacity; halo uses currentColor, active width +3. | Normal width 2; series.width overrides it. Active default 1.65×, never thinner; zero hides the stroke. Theme-aware/custom halo defaults active +4. | Different width/halo policies. Parallel per-series dash and opacity remain missing DreamLake capabilities; do not silently translate them to chart-wide styles. |
| Responsive layout | Default 325×220; 60px internal left/right insets; aside legend can enlarge the right inset. axisSpacing is an absolute gap. Inherited margin, padding, plotRef are unused here. | Parent width is measured; independent paddingLeft=0 and paddingRight=0; minAxisSpacing=0 fills available width. Plot height 290. | Intentional layout difference. With at least two visible axes, first/last axes reach usable edges. Labels align inward without implicit padding. Absolute spacing is not a minimum-spacing alias. |
| Hover values and placement | Labels below; hoverLayout="auto" means above each hovered point. Numeric values use two decimals; strings retain text. | Labels above/below; auto values appear opposite the label side. Raw formatted value at every visible axis, plus a full explanation below. | Specify placement explicitly. Numeric formatting may differ without changing observations. |
| Selection and hover state | Controlled selectedIndices, onSelectionChange(indices), multiSelect=true, onHover(index or null). | Controlled selectedIds, onSelectionChange(ids); internal hover/focus preview; UIKit virtualization and shared Experiments drag-selection controller. | Rebuild index-to-ID mapping after filtering/reordering. Public parallel hover callback and single-select prop remain gaps; a host can enforce single selection in its callback. |
| Axis settings and persistence | Exported Jotai atoms axisConfigsAtom, axisConfigByNameAtom, toggleAxisTypeAtom; localStorage key parallel-axis-configs, keyed by display name. Props initialize absent names. | Click axis or label to cycle modes. Local defaults or controlled axisModes / onAxisModesChange; stable-ID keys; no implicit persistence. No callback means controlled modes are read-only. | Vuer has real external state access, but duplicate names share settings and multiple-chart initialization can overwrite restored modes. Persist a deliberate serializable subset in the DreamLake host. |
| Callable axis strategies | External atoms expose type, bounds and categories; no parallel log/custom-transform prop. | axisModeOptions, category functions, auto/uniform/explicit/function domains, linear/log/custom transform + inverse + ticks, and numeric accessors. | DreamLake additions execute in geometry and ticks. Store strategy IDs rather than serializing functions. Log axes require positive values; invalid strategies report unavailable positions. |
| Keyboard and touch | SVG axis text/lines have mouse handlers but no native focusable axis controls; demo table buttons are separate controls. | Keyboard-accessible experiment list and axis-label buttons. Arrows navigate runs; Space/Enter toggle runs or cycle a focused axis. Touch scrolls/taps; Escape clears selection/preview. | Component accessibility differs from example accessibility. Retain semantic controls when integrating charts with a table. |
| Composition and missing tools | legend, layout, SVG children; parallel does not install ChartContext.Provider. No public brush/reorder API. | Built-in run controls/readouts, no arbitrary overlay slot, no brush/reorder API. | Overlay composition remains a DreamLake gap. Vuer generic context overlays are not automatically valid inside parallel merely because children renders. |
Data and selection migration
Use effective legacy axis settings, including any persisted modes, rather than assuming initial dimension props still describe the displayed plot. This adapter requires complete finite bounds or category lists and preserves original observations. Omitted widths adopt DreamLake defaults; explicit zero widths follow DreamLake’s hidden-stroke contract. It does not recreate Vuer's implicit string parsing, numeric-to-string category coercion, dash/opacity overrides, or persistence policy.
Keep selection in stable IDs in the host when possible. During an incremental migration, derive selected IDs from the current record order and rebuild the inverse map whenever records change:
For a single-selection host, retain the newly added ID rather than always taking the first existing selection. Preserve exact domains and explicitly choose any numeric-text conversion. The modes example demonstrates real caller functions, and padding examples cover zero and asymmetric insets with resizing.
Other overlapping components
Sources: Vuer root exports, common types, line types, data-provider exports, DreamLake root, and DreamLake package exports. The linked component pages provide runnable examples and detailed props.
| Surface | Vuer-Viz contract | DreamLake contract | Assessment / migration |
|---|---|---|---|
| Lines and bands | LineChart / LineSeries: flat x/y/low/high, optional TimeSeries children, points, lineStyle (dashArray on TimeSeries), showArea; band opacity defaults 0.3. | EpisodeLineChart: stable IDs, required color, nested data, width/dash/opacity, caller bounds; band opacity defaults 0.16. | Nest arrays without resampling. Preserve band visibility/opacity explicitly. No equivalent point-marker or TimeSeries child API. |
| Line stroke policy | Normal line width defaults to 2 through logical OR; zero falls back. Active line width adds 1px. | Normal width 2; zero hides the stroke; active defaults to 1.65× and may be configured explicitly. | Preserve intended styling explicitly. Similar width names do not imply the same zero/active behavior. |
| Numeric/time axes | xMin/xMax/yMin/yMax, tick counts; formatter name or function returning both ticks and labels. | duration, numeric xAxis, yRange, formatTick; time-specific labels or shared numeric helpers. | Explicit mapping required. Vuer's formatter named log is not a logarithmic coordinate-transform API. DreamLake formatTick changes text, not tick placement. |
| Hover identification | Line highlightOnHover=false, highlightThreshold=Infinity, label-based identified series. | highlightOnHover=false, highlightThresholdPx=8, controlled activeSeriesId / onActiveSeriesChange. | Distances/defaults and identity differ. Use stable IDs; an infinite nearest-series search is not the same as a bounded proximity threshold. |
| Cursor events | onChange(ChartChangeEvent) with x/y, bounds, event type and optional nearest point; VerticalMarker, Tooltip, SeriesTooltip. | time, onHover, onHoverEnd, onSeek, ownership and integrated portaled cursor readouts; TimelinePreviewController / useTimelinePreview. | Map hover to preview and click to commit. A cursor coordinate is distinct from the nearest recorded sample; do not turn every hover into a permanent selection. |
| Zoom and pan | useZoom, usePan, useZoomPan, explicit bounds, plot ref; combined hook takes min/max/setMin/setMax. | zoom, panPct, onViewportChange, optional limits shared with EpisodeTimeline. | There is no DreamLake viewport prop. For visible [a,b] within [0,duration], map to zoom=duration/(b-a), panPct=a/duration; handle zero spans and limits explicitly. |
| Dense rendering | canvas opt-in, default SVG. | rendering="auto" or "exact"; visible-window culling and extrema-preserving SVG display reduction, original-sample readouts. | Different renderer contracts. Compare representative inputs and interactions before making speed claims; display reduction does not replace stored observations. |
| Marks and intervals | Context-aware SVG children and VerticalMarker; range examples are custom overlays, not a generic range component. | markers / ranges props and EpisodeTimeline tracks. | Different coordinate and composition contracts; translate bounds and lifecycle explicitly. Parallel lacks the line-chart context provider on the Vuer side. |
| Images | Image: fit, position, caption, loading, zero-argument load/error callbacks. | ImageView / ImagePreview: view/loader composition; onLoad(resolution: string). | Partial overlap, not a component rename. DreamLake ImageView has no direct fit/position props. |
| Video and frames | Video: src/sources/glob, controlled time, controls/playback, frame snapshot callback, unified change event. | EpisodeVideoStack, EpisodeFrameStack, native VideoView / preview. | Map sources to stable IDs and episode time deliberately. Video stacks require duration; frame stacks derive their span. A native file preview is not controlled multi-camera playback. |
| Text / README / ANSI | Text, README, ANSI: rich formats, syntax/terminal themes, TOC, loading options. | TextView / TextPreview, explicit loading and optional async save. | No matching DreamLake public Markdown/ANSI/TOC contract. Preserve required rich rendering with a separate renderer rather than silently converting it to plain text. |
| Bars and heatmaps | BarChart: columnar labels/values/colors, index selection; Heatmap: matrix, scales, cell callbacks. | No generic public BarChart or Heatmap export in the inspected package. | Missing DreamLake components. Tables and image previews are not substitutes. Prioritize concrete consuming workflows. |
| Theme and layout | Shared BaseChartProps, primitives (Axes, Grid, Legend, ChartLayout), fixed dimensions, Times New Roman / 18px defaults. | Responsive UIKit embedding, compact sizing, transparent chart defaults, host Tailwind v4 source scanning and theme. Media/file compositions may have surfaces. | Intentional integration choice. Do not add filled chart backgrounds for parity. In Vuer, shared inherited props are not necessarily consumed by every chart. |
| Data acquisition | SeriesDataProvider, TabularDataProvider, SweepDataProvider, GlobDataProvider; useSeriesData() and peers return callable hooks backed by supplied fetch functions. | schema-viz, dataset-viz, storage/format/view registries and file loaders. | Different responsibility boundaries. Bare useSeries / useTabular are not Vuer root exports; example-local hook names are not import names. Translate query/aggregation and authorization ownership explicitly. |
| Package entry points | Root ESM export only; exports charts, primitives, hooks, formatters, context, types and raw type strings. | Root plus documented episode/parallel/media/file/timeline/dataset/schema/3D subpaths and CSS. EpisodeFrameStack is root-exported without a dedicated frame-stack subpath. | Use declared exports rather than copying internal paths. Dataset/schema registries have a different lifecycle from chart children or data providers. |
Line-data migration
This adapter preserves arrays and explicit band visibility, uses the legacy default band opacity, and requires a stable ID, resolved color, and an already-translated SVG dash pattern. Validate equal array lengths, ascending finite x coordinates, and the intended x units before rendering. It does not invent point-marker support.
Use xAxis={{kind: "numeric", label: "step"}} for training steps instead of time labels. duration supplies the x-domain upper bound; arbitrary legacy domains may need host-level coordinate adaptation rather than a prop rename. Keep physical values in their original units and format labels separately.
Inconsistencies, gaps, and follow-up
- Corrected documentation: the current Vuer site now uses a typed flat-array first-chart example, removes nonexistent 3D exports from Getting Started, and displays source-generated interfaces and a build revision. Parallel docs distinguish supplied category lists from click-generated truncation and correctly state 1.3× highlights. The older npm declaration comments are still misleading; a package patch can align those comments with the website.
- Vuer runtime/type inconsistencies: parallel maximum zero and zero widths fall through
||; curved geometry and straight-segment hit testing differ; inherited parallelmargin/padding/plotRefand line-chartpaddingare unused. PublicChartTypeomits parallel while root exports it, andChartConfig.propsisunknown. Describe or fix these contracts rather than copying implementation accidents. - State and overlay limits: Vuer's exported atom API is real, but name-keyed persistence can collide between charts and initialization can overwrite restored settings. Parallel children do not inherit
ChartContext. DreamLake intentionally uses stable IDs and explicit modes; its parallel hover callback, per-series dash/opacity and arbitrary overlay slot remain useful missing capabilities. - Current example issues: the fresh expanded Vuer crawl encountered hydration errors on the marker guide and four hook routes despite HTTP 200. Marker fixtures use module-scope random values; hook source routes use camelCase while production redirects lowercase. A marker code fence uses unscoped
vuer-viz, and theuseZoomPanJSDoc example uses names differing from the implemented parameters. These findings require exact-route runtime fixes and verification, not a claim that the whole site is broken. - Recommended compatibility work: publish explicit adapters for positional data/selection and for event/viewport ownership; compile examples against the exact package types; expose only aliases that retain semantics. Add missing components when there is a real consumer. Do not conflate a generic bar/heatmap gap, an intentional dataset architecture, and a documentation typo.
- Evidence limits: declarations and implementation establish the mapped API surface; examples establish observed interactions. The audit does not certify every browser engine, storage backend, query provider, or every accessibility combination. Accessibility, reduced-motion, responsive and performance results must name the tested component and inputs.