<!-- source: https://viz.dreamlake.ai/guides/legacy-vuer-viz-comparison @ 0.32.5 74e6877e -->

# 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](/guides/api-comparison.md). 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](https://viz.vuer.ai/) displayed **1.2.14**. Its [published package](https://www.npmjs.com/package/@vuer-ai/vuer-viz/v/1.2.14) 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](https://github.com/dreamlake-ai/viz-workspace/pull/158)). The DreamLake column describes the implementation shipped with this page: see the site's version badge and [versioned source](https://github.com/dreamlake-ai/viz-workspace/tree/v/0.31.4). The previous 0.28.6 interaction release is [PR 157](https://github.com/dreamlake-ai/viz-workspace/pull/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](https://unpkg.com/@vuer-ai/vuer-viz@1.2.14/dist/src/index.d.ts), [Vuer common types](https://unpkg.com/@vuer-ai/vuer-viz@1.2.14/dist/src/types.d.ts), [Vuer embedded implementation](https://unpkg.com/@vuer-ai/vuer-viz@1.2.14/dist/index.js.map), [DreamLake public exports](https://github.com/dreamlake-ai/viz-workspace/blob/v/0.31.4/packages/viz/src/index.ts), [DreamLake package exports](https://github.com/dreamlake-ai/viz-workspace/blob/v/0.31.4/packages/viz/package.json). Source inspection supports behavioral claims; this is not a performance comparison between the two libraries.

## Parallel coordinates first

Sources: [Vuer examples](https://viz.vuer.ai/charts/parallel/), [Vuer props](https://unpkg.com/@vuer-ai/vuer-viz@1.2.14/dist/src/charts/parallel-axis/ParallelAxis.types.d.ts), [Vuer store](https://unpkg.com/@vuer-ai/vuer-viz@1.2.14/dist/src/charts/parallel-axis/parallelAxisStore.d.ts), [DreamLake examples and props](/components/parallel-coordinates.md), [DreamLake types and model](https://github.com/dreamlake-ai/viz-workspace/tree/v/0.31.4/packages/viz/src/parallel-coordinates).

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

```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](/components/parallel-coordinates.md#axis-modes-and-custom-functions) 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`](https://viz.vuer.ai/charts/line): flat `x`, `y`, optional `low/high`, `lineWidth`, `lineStyle`, `showPoints`                        | [`EpisodeLineChart`](/components/episode-line-chart.md): 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`](https://viz.vuer.ai/guides/data-formatters), formatter-name or tick/label function                                   | [`xAxis`, `yRange`, `formatTick`, numeric helpers](/components/numeric-axis.md); 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)`](https://viz.vuer.ai/guides/event-handling), `VerticalMarker`, `SeriesTooltip` children; event includes bounds/type/nearest point | [`time`, `onHover`, `onHoverEnd`, `onSeek`, `isScrubOwner`](/components/series-identification.md); 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](https://viz.vuer.ai/guides/canvas-rendering)                                                                                                  | `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](https://viz.vuer.ai/guides/zoom-and-pan) and marker/custom-range overlays                                         | `zoom` / `panPct` / `onViewportChange`, markers/ranges props; [`EpisodeTimeline`](/components/episode-timeline.md) for tracks                              | Explicit adapter needed. General child overlays and episode tracks have different lifecycles and coordinate contracts.                                                                          |
| Image                  | [`Image`](https://viz.vuer.ai/charts/image): fit/position/caption/loading/error callbacks                                                                       | [`ImageView` / `ImagePreview`](/file-preview/views.md): 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`](https://viz.vuer.ai/charts/video): src/sources, controlled time, scrub/play events, snapshot function; glob needs server support                      | [`EpisodeVideoStack`](/components/episode-video-stack.md), [`EpisodeFrameStack`](/components/episode-frame-stack.md), `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`](https://viz.vuer.ai/charts/text), [`README`](https://viz.vuer.ai/charts/readme), [`ANSI`](https://viz.vuer.ai/charts/ansi)                             | [`TextView`, `TextPreview` and file loading](/file-preview/composed.md)                                                                                    | 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`](https://viz.vuer.ai/charts/bar); [Heatmap types](https://unpkg.com/@vuer-ai/vuer-viz@1.2.14/dist/src/charts/heatmap/Heatmap.types.d.ts) 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](https://viz.vuer.ai/guides/layout); 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](https://viz.vuer.ai/visual-grammar/data-hooks)                                    | [`StorageSchema` sources/panels](/schema-viz/overview.md), [Dataset adapters and `.dreamrc`](/dataset-viz/reference.md), 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

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.
