DreamLake
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.

AreaVuer 1.2.14DreamLake 0.31.4Assessment / migration
Component and dataParallelAxis, dimensions, each series has an ordered values arrayParallelCoordinates, axes with stable id and label; values keyed by axis IDIntentional identity contract. Assign durable record and axis IDs before conversion; labels need not be unique.
Numeric limitsDimension min / max; implicit numeric string parsingdomain: [min,max]; auto nice-number bounds; raw strings remain strings unless numericValue is suppliedIntentional exact-data contract. Convert limits explicitly; do not silently parse research data.
CategoriesString categories; click-generated lists truncated to 10; unsupported category normalizes to bottomString and numeric categories remain distinct; ordered arrays or functions; unknown values create gapsIntentional missing-data behavior. No equivalent 10-category cap; readability still limits dense categorical axes.
CurvesCatmull–Rom style cubic interpolation for 3+ points; straight segment for twoStraight segments by default; curve="smooth" opts into bounded cubic connectors, including two axesIntentional: exact endpoints and no overshoot beyond each segment's values. Curves are visual connectors, not inferred measurements.
Width and haloPer-series lineWidth, opacity, lineStyle; normal default 3; actual highlight default 1.3×; currentColor understroke +3lineWidth=2 plus series.width; active default base × 1.65, halo default active +4; theme-aware or activeHaloColorMissing parity: per-series dash/opacity controls. Theme-aware halo is a DreamLake addition.
LayoutFixed 325×220 default; internal 60px side insets, larger right legend inset; axisSpacingMeasures parent width; independent paddingLeft=0, paddingRight=0; minAxisSpacing=0 fills width, opt-in scrolling; plot height 290Intentional responsive default. axisSpacing is not a direct rename: DreamLake's setting is a minimum.
Labels/readoutsAxis labels below; hoverLayout auto resolves above; numeric hover rounds to two decimalslabelPlacement above/below; hoverLayout auto chooses opposite side; raw formatted value at every axis plus full textual explanationSame placement vocabulary, different auto rule. Specify placement explicitly for visual parity.
SelectionselectedIndices, callback indices, multiSelect; onHover(index or null)Controlled selectedIds, callback IDs; keyboard row controls; no public hover callback or single-select propIntentional IDs; hover callback is a remaining capability gap. Single selection can be implemented in the host callback.
Axis changesLabel/line click toggles type; Jotai atom persisted in localStorage, keyed by display nameNative label dialog; component-local defaults or controlled axisModes / onAxisModesChange; no implicit persistenceIntentional isolation. Controlled modes without callback are read-only. Hosts can persist a serializable subset by stable ID.
Modes and functionsStore exposes vtype, low, high, categories; no parallel log/custom-transform propNumeric/category, linear/log/custom transform+inverse+ticks, exact/auto/uniform/function domain, category/accessor functionsDreamLake additions. Functions run in geometry and ticks, not just notifications; persist strategy IDs rather than serializing functions.
Invalid/missing valuesPublic values type excludes null; numeric parse and fallback positioning in implementationNull/nonfinite/nonnumeric/unknown/out-of-domain values leave gaps; nonpositive log values reported; raw hover remains visibleIntentional stricter semantics. Selection uses the same configured paths as rendering. Neither API declares an axis range brush or reorder callback.
Legend/overlayslegend, layout, children slotsKeyboard-selectable run list, active values; no arbitrary overlay slotMissing 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.

tsx
const axes = dimensions.map((d, i) => ({
  id: axisIds[i],
  label: d.name,
  ...(d.type === "categorical"
    ? { type: "categorical" as const, categories: d.categories ?? [] }
    : {
        type: "continuous" as const,
        domain:
          d.min !== undefined && d.max !== undefined
            ? ([d.min, d.max] as const)
            : undefined,
      }),
}));
const records = legacySeries.map((s, i) => ({
  id: recordIds[i],
  label: s.label,
  color: s.color,
  values: Object.fromEntries(axes.map((axis, j) => [axis.id, s.values[j]])),
}));
const selectedIds = selectedIndices.map((i) => records[i].id);
<ParallelCoordinates
  axes={axes}
  series={records}
  selectedIds={selectedIds}
  onSelectionChange={(ids) =>
    setSelectedIndices(
      ids
        .map((id) => records.findIndex((row) => row.id === id))
        .filter((i) => i >= 0),
    )
  }
  labelPlacement="below"
  hoverLayout="above"
/>;

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.

tsx
const axisModes = {
  loss: {
    domain: ({ values }) => [0, Math.max(1, ...values)],
    scale: {
      label: "Square root",
      transform: Math.sqrt,
      inverse: (value) => value * value,
      ticks: ({ domain }) => [0, domain[1] / 4, domain[1]],
    },
  },
} satisfies ParallelAxisModes;
// Pass axisModes plus onAxisModesChange for editable controlled state.

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

SurfaceVuer API / live documentationDreamLake API / live documentationIntentional difference or follow-up
Lines and bandsLineChart, LineSeries: flat x, y, optional low/high, lineWidth, lineStyle, showPointsEpisodeLineChart: stable series id, nested data: {x,y,low,high}, required color, width, dash, formatValueNest arrays and add IDs/color. Preserve original samples. Point markers remain a gap; both now use non-scaling CSS-pixel widths.
Numeric axesxMin/xMax/yMin/yMax, xFormat/yFormat, formatter-name or tick/label functionxAxis, yRange, formatTick, numeric helpers; time axes separateIntentional 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 eventsonChange(ChartChangeEvent), VerticalMarker, SeriesTooltip children; event includes bounds/type/nearest pointtime, onHover, onHoverEnd, onSeek, isScrubOwner; integrated portaled readout, nearest recorded samplesIntentional shared-playhead ownership. Map hover to preview and click to commit; don't set a permanent selection on every pointer move.
Dense renderingcanvas opt-inrendering="auto" / "exact", visible-window culling and extrema-preserving SVG display reductionDifferent renderer contract. Both need workload-specific measurements; no claim of cross-library benchmark superiority.
Zoom, marks, intervalsuseZoom, usePan, useZoomPan, overlays and marker/custom-range overlayszoom / panPct / onViewportChange, markers/ranges props; EpisodeTimeline for tracksExplicit adapter needed. General child overlays and episode tracks have different lifecycles and coordinate contracts.
ImageImage: fit/position/caption/loading/error callbacksImageView / ImagePreview: image/file-preview composition, resolution callbackPartial overlap. No direct fit/position prop on ImageView. Its onLoad returns a resolution string, not Vuer's zero-argument event.
VideoVideo: src/sources, controlled time, scrub/play events, snapshot function; glob needs server supportEpisodeVideoStack, EpisodeFrameStack, VideoView/previewIntentional 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 / ANSIText, README, ANSITextView, TextPreview and file loadingMap 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 heatmapsBarChart; Heatmap types exportedNo public generic BarChart/Heatmap equivalent in inspected exportsMissing DreamLake surface. Dataset table/image views are not equivalent. Prioritize only when an actual consumer needs them.
Layout/themeBaseChartProps, ChartLayout, axes/grid/legend primitives; numeric fixed dimensions, matplotlib typographyParent layout, compact sizes, transparent chart defaults; host Tailwind v4 source scanning and data-theme; composed media may have surfacesIntentional UIKit embedding. Do not introduce a filled chart background to mimic another theme. Generic ChartLayout/primitive parity is absent.
Data acquisitionuseSeriesData, useTabularData, useSweepData, useGlobData, providersStorageSchema sources/panels, Dataset adapters and .dreamrc, file loadersDifferent abstraction boundaries. Query aggregation functions and format-specific recording readers need explicit adapters; no automatic one-to-one migration.
ImportsRoot package exposes chart primitives, hooks and formatters; bundled ESM declarationsRoot plus documented parallel-coordinates, episode/file/media subpaths; dataset/schema APIs via subpaths; shipped CSS/source for TailwindUse 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

  1. Vuer docs/source drift: the homepage's first example passes data: [{x,y}], while published LineSeries and the line-chart page use flat x/y arrays. Use the published type when migrating. The parallel highlight comment says 3× while implementation uses 1.3×. Parallel inherits margin/padding from BaseChartProps but its implementation calculates internal margins without reading those props. These are reference inconsistencies, not contracts to reproduce.
  2. 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.
  3. DreamLake naming consistency: both parallel and episode charts share chart-level lineWidth / activeLineWidth and per-series width since 0.28.7. Domain modes versus episode yRange / formatTick still 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.
  4. 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.
  5. 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.