NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev
A composable Flutter treemap with immutable hierarchical data, multiple layouts, drill-down interaction, and replaceable visual layers.
Latest stable
4.0.0
Last release 1 months ago
16 Oct 2026
Too new to tell
only 2 release windows
Nearly every release is documented
notes for 6 of 6 stable releases
Nothing withdrawn
no release was ever pulled
3 months old
6 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
Breaking: TreemapLabelConfig.spacing now separates custom canvas linesBuilder blocks too. Vertical fit and automatic available-space reservation inclu
TreemapLabelConfig.spacing now separates custom canvas
linesBuilder blocks too. Vertical fit and automatic available-space
reservation include every gap. Nominal automatic parent headers include
their title/value gap consistently; additional custom lines require an
explicit parent height.TreemapCenteredWidgetLayer now uses available content space,
excluding reserved headers and labels, by default. Set
region: TreemapContentRegion.tile to retain the full-tile allocation from
3.0.1. Factors, aspect fitting and cutoffs apply to the selected region.TreemapLayoutConfig at
zero. Presets can still declare their own spacing.TreemapContentRegion.tile opts into full
tile bounds. Sizing, aspect fitting and cutoffs use the selected region.TreemapLabelPlacementProvider without changing existing label
implementations. Structural parent headers are respected without double insets.TreemapCenteredTextLayer.fixed for single-line canvas text fitted to a
shared template, with independent factors, optional aspect ratio and size
cutoff. The template itself defines the sizing budget; no length or font size
is required. Text is centered with a fixed line height and uniform canvas scale.Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
Added TreemapCenteredWidgetLayer for centered widget content over deepest visible blocks, including collapsed parents and aggregates. Independent widt
TreemapCenteredWidgetLayer for centered widget content over deepest
visible blocks, including collapsed parents and aggregates. Independent width
and height factors default to 1.0; optional aspect fits a width-to-height
ratio inside those resolved dimensions before an optional Size cutoff skips
undersized content without changing tile geometry or invoking its builder.FittedBox
inside the builder when the content itself should scale.Breaking: moved resolveParentHeaderHeight(context) directly onto TreemapLabelLayer and removed TreemapLabelLayoutProvider without an alias. Custom lab
resolveParentHeaderHeight(context) directly onto
TreemapLabelLayer and removed TreemapLabelLayoutProvider without an alias.
Custom label layers implement the method, returning null to disable reserved
headers or delegating to their wrapped layer. Sizing still runs before geometry
using configuration and inherited metrics; rendering remains downstream.appearance nor
fallbackAppearance; resolveTileAppearances(context) has no fallback argument.
Shared backgrounds drive contrast and custom-line callbacks independently of
label typography and header sizing.TreemapTileLayer directly declares the nullable appearance
getter. Custom implementations supply or delegate their source, or return null;
no separate provider interface or runtime capability checks are needed.TreemapVisualContext.tileAppearance / resolveTileAppearances.
TreemapNoopTileLayer(appearance: ...) declares the background labels should
assume while painting nothing. Sources remain optional for geometry-only hosts
and arbitrary widget labels; canvas labels require a declared tile source.appearance-label-fallback URL now demonstrates invisible tile-owned
backgrounds; its stable ID is retained.TreemapAppearance to
TreemapLabelConfig. Rectangle appearances now contain only paint styling.
Base styles, zero padding and zero spacing retain their defaults.TreemapLabelStyle, label hoverStyle, selectedStyle,
focusedStyle, and nodeStyleResolver. resolveStyles applies base, hover,
selection, focus and final per-node overrides, replacing each complete style.
Override fields support explicit null resets in copyWith.config.resolveStyles(context, details, states).linesBuilder receives resolved styles as its fourth
argument; direct resolveLines calls require the styles named argument.
Final explicit colors/foreground paints override automatic contrast fallback.No deprecated aliases, forwarding constructors or compatibility adapters are provided. Migration guidance is confined to this changelog.
TreemapSingleChildPolicy.promote to normalization. Non-root
single-child branches and repeated chains are replaced before the prepared
tree is used. The root and child metadata are preserved; removed parent
metadata, keys and colors are discarded. Navigation, breadcrumbs, layout
depths and color domains use only the resulting hierarchy. The default
preserve policy retains existing behavior, and all input is validated first.data-single-child-promotion preset. Automatic saturation now promotes B's
only child Sixty, so its 60 tile stays at the root when clicked.TreemapNormalizedTree prepared explicitly with
TreemapNormalizer.normalize. Validation, indexes, branch totals and global
color extrema are computed once and reused.TreemapPresentationState and send keyed TreemapActions. Removed controller
inputs from legends/breadcrumbs and duplicate fields from visual contexts.onSnapshot, its callback typedef, controller hover
APIs, zoomIn and zoomToPathEntry. onPresentationChanged is the sole
chart-output callback, coalesced after the frame.data-prepared-tree adds two charts
sharing one prepared source with independent interaction and visible domains.Prepare data once when it changes, and replace chart/layout root inputs with
tree. A controller can bind the same prepared input before standalone commands:
// v1
TreemapChart(root: root, tiles: tiles);
engine.layout(root: root, viewport: viewport);
controller.synchronize(root);
// v2
final tree = TreemapNormalizer.normalize(root);
TreemapChart(tree: tree, tiles: tiles);
engine.layout(tree: tree, viewport: viewport);
controller.synchronize(tree);
Replace onSnapshot: (snapshot) => ... with
onPresentationChanged: (state) => ... and read state.targetSnapshot for layout
or state.displayedSnapshot for the painted frame. Output callbacks now run after
the frame; keep prepared inputs stable during observer-driven rebuilds.
Read hover from state.hoveredKey/state.hoveredColor; replace controller hover
writes with visual.actions.hover(key) or TreemapPresentationScope.actionsOf.
Use controller.zoomTo(key) for explicit navigation. Aggregate reveal now accepts
its key and memberKeys, while custom chart layers use actions.revealAggregate(key).
Custom layers read visual.presentation.displayedSnapshot, .details, .statesFor,
.selectedEntries and .isAnimating. Replace visual.controller, onActivate
and onFocus with keyed visual.actions commands. Surrounding build/wrap
callbacks receive TreemapVisualContext instead of a controller.
Pass presentation to an external legend. Breadcrumbs accept presentation and
onNavigate: (entry) => controller.zoomTo(entry.key.sourceKey!). Inside a chart,
built-ins use the presentation scope and actions automatically. Standalone
presentation uses TreemapPresentationState.fromData(tree: tree, targetSnapshot: snapshot);
static standalone legends may still use explicitly resolved scales. Remove controller resolveColorScale and synchronizeLayout calls. Resolve
automatic scales with presentation.resolveColorScale or scale.resolveDomain.
No deprecated aliases, forwarding constructors or compatibility adapters are provided. Migration guidance is confined to this changelog.
Added TreemapLayoutConfig.maxVisibleDepth for depth-limited rendering relative to the current zoom focus. Boundary branches retain full totals and dri
TreemapLayoutConfig.maxVisibleDepth for depth-limited rendering
relative to the current zoom focus. Boundary branches retain full totals
and drill-down behavior; null preserves unlimited depth. The category card
example compares All (null), Depth 1, and Depth 2 above the chart.Added TreemapChart.surrounding, TreemapSurroundingContent, and TreemapSurroundingGrid for placing breadcrumbs, legends, and custom content in eight di
TreemapChart.surrounding, TreemapSurroundingContent, and
TreemapSurroundingGrid for placing breadcrumbs, legends, and custom content
in eight direction-aware cells around the treemap. The grid supports named
slots or fromMap, uses standard flex layout, and leaves sizing to callers.widget and builder factories.TreemapChart now consumes
replaceable tile, label, semantics, tooltip, and surrounding-layer contracts;
all contracts and implementations share the any_treemap.dart entry point.TreemapCanvasLabels and fully customizable, per-node
clipped TreemapWidgetLabels. Canvas labels support a configurable ellipsis;
label rendering no longer measures or changes layout geometry.TreemapNode; minimum width, height,
and area thresholds now belong exclusively to TreemapLayoutConfig.colorValue inputs to color. A Flutter Color
now bypasses the included appearance resolver's configured color scale.emptyBuilder, TreemapEmptyBuilder, and TreemapEmptyState;
empty geometry now always produces the neutral SizedBox.shrink output.TreemapNode.fromRecords and removed both
TreemapNodeFactory and TreemapChart.fromRecords.