timeline_v7 library

Structured-style planner UI, styled views and drag interactions (version 7.x).

Adds the structured timeline widgets and style system on top of V6.

Import this if you want to use only the V7 API (includes V4–V6):

import 'package:neon_timeline_flutter/timeline_v7.dart';

Classes

AgendaView<T>
Text-first chronological view with lazy rows and optional day headers.
CalendarDayView<T>
Modern absolute-positioned day canvas with overlap columns and a static grid layer. It creates no ticker and performs no work while idle.
DependencyTimelineView<T>
Interactive dependency map with deterministic topological layers.
ListTimelineDataSource<T>
Mutable in-memory source suitable for local state and examples.
PlannerView<T>
Dense schedule preset for task, shift, and resource planning surfaces.
PresentationTimelineView<T>
Read-only timeline preset for reports, screenshots, and presentations.
ResourceTimelineView<T>
Multi-resource planning board for people, rooms, machines, and teams.
RoadmapView<T>
Horizontal milestone-oriented timeline with stable lazy rendering.
ScheduleView<T>
Planner-grade schedule using neutral entries, themes, and interaction policy.
StructuredTimelineEntryDetails<T>
StructuredTimelineMoveDetails<T>
StructuredTimelinePlanner<T>
Convenience bridge from application-owned models directly to the Structured-style 7.x timeline.
StructuredTimelineStrings
Package-owned default labels. Applications can replace every visible word without depending on intl or a specific localization framework.
StructuredTimelineStyle
Design tokens for the Structured-style planner timeline introduced in 7.x.
StructuredTimelineView<T>
A production-oriented, app-friendly day timeline based on the interaction and visual language of the Structured planner.
TimelineActivityIndex<T>
Calendar-friendly index used for week strips, month sheets, heatmaps, and activity dots without coupling the package to an application's date picker.
TimelineAnalytics
Aggregate planning metrics with an O(n log n) concurrency sweep.
TimelineAnalyticsSnapshot<T>
TimelineAutoScrollPolicy
TimelineBackdrop
Theme-aware background surface for full-screen timeline products.
TimelineBoardView<T>
TimelineCapacityConflict<T>
TimelineCapacityEngine
Resource overbooking sweep. Adjacent ranges do not conflict.
TimelineCard
Modern, neutral task card with no permanent ticker or storage behavior.
TimelineCommand
Reversible application command used by direct manipulation and shortcuts.
TimelineCommandHistory
Serial command history with guarded undo and redo.
TimelineCommandPalette
TimelineConflictGroup<T>
A connected overlap cluster produced in linear time after sorting.
TimelineConflictResolution<T>
TimelineConflictSolver
Deterministic conflict repair used by planner applications before they persist changes. Entries are kept in stable start order and pushed forward only when necessary.
TimelineController<T>
Host-owned controller for selection, zoom, focus, and visible-range state.
TimelineDataSource<T>
Backend-independent source contract for future paged and live adapters.
TimelineDateActivity<T>
TimelineDateRange
TimelineDayConflict<T>
TimelineDayEntry<T>
TimelineDayEntryDetails<T>
TimelineDayGap<T>
TimelineDayInsight<T>
TimelineDayLayoutEngine
Deterministic overlap-column assignment for day and resource canvases.
TimelineDayLayoutItem<T>
Positioned entry produced by TimelineDayLayoutEngine.
TimelineDayNode<T>
TimelineDayPlan<T>
TimelineDayPlanBuilder
TimelineDayPlanConfig
TimelineDependency
TimelineDependencyAnalysis<T>
TimelineDependencyEngine
Dependency analysis with O(V + E) graph traversal after ID indexing.
TimelineDependencyIssue
TimelineDependencyNodeDetails<T>
TimelineDiagnostics
Opt-in snapshot delivery. It creates no timer and no continuous work.
TimelineDiagnosticsSnapshot
TimelineDropResult<T>
TimelineEntry<T>
Application-owned value adapted to the neutral 4.x timeline engine.
TimelineEntryAdapter<T>
Maps an application-owned model to the neutral TimelineEntry contract.
TimelineEntryDetails<T>
Normalized builder context shared by the new view widgets.
TimelineFocusView<T>
TimelineGap<T>
TimelineInteractionConfig
Interaction policy shared by schedule and planner views.
TimelineLayoutConfig
Generic orientation and layout settings shared by view widgets.
TimelineLocalization
Injects package-owned fallback strings below a subtree.
TimelineLocalizationData
Host-supplied strings used by package-owned neutral UI fallbacks.
TimelineMatrixView<T>
TimelineMetricCard
TimelineMotionConfig
Motion policy. It never changes layout or data semantics.
TimelineMoveProposal<T>
TimelineNormalizedEntry<T>
TimelineOverviewStrip<T>
TimelinePaletteCommand
TimelinePanel
Reusable modern panel. Backdrop blur requires both a glass-capable theme and explicit per-panel opt-in, so dense dashboards remain cheap by default.
TimelinePerformanceConfig
Neutral 4.x performance policy with a compatibility bridge to 3.x painters.
TimelinePlannerDayBuilder<T>
Cached builder that feeds application-owned UI with a complete day plan.
TimelinePlannerDaySnapshot<T>
TimelinePlannerEngine<T>
High-level facade for application integration.
TimelinePlannerWindow<T>
Reusable recurrence expansion for several planner surfaces.
TimelinePlannerWindowBuilder<T>
Caches one bounded planner expansion for several application-owned views.
TimelinePlugin
Versioned extension point. The registry is host-owned, never global.
TimelinePluginRegistry
TimelineQuery<T>
TimelineQueryResult<T>
TimelineRecurrenceRule
TimelineRenderPlan<T>
Immutable, deterministic plan shared by the 4.x view and diagnostics layer.
TimelineRenderPlanBuilder<T>
Stateful cache boundary for widgets that consume a render plan.
TimelineRenderPlanCache<T>
Reusable render-plan cache with explicit revision-based invalidation.
TimelineReschedulePolicy
TimelineReschedulePreview<T>
TimelineRescheduleSession<T>
Pure rescheduling engine for long-press drag, keyboard movement, or custom gesture systems. The package computes snapping, clamping, and conflict preview; the host decides how and where to persist the result.
TimelineResource
A person, room, machine, team, or other schedulable resource.
TimelineResourceCapacity
TimelineResourceEntryDetails<T>
TimelineScenario<T>
TimelineScenarioChange<T>
TimelineScenarioCompareView<T>
TimelineScenarioComparison<T>
TimelineScenarioEngine
TimelineSectionHeader
TimelineSeriesAdapter<T>
TimelineSeriesExpander<T>
Expands recurring series and applies single-occurrence overrides.
TimelineSeriesExpansion<T>
TimelineSeriesItem<T>
TimelineStatusBadge
TimelineTemporalHit<T>
TimelineTemporalIndex<T>
Immutable temporal index for fast range queries.
TimelineTheme
TimelineThemeData
Complete design-token set for the neutral 4.x UI layer.
TimelineView<T>
Neutral, lazy timeline view backed by the proven 3.x renderer.
TimelineWeekLane<T>
TimelineWeekPlan<T>
TimelineWeekPlanBuilder
Builds the seven vertical day lanes seen in compact week planners while leaving every visual decision to the consuming application.
TimelineWorkspace
Responsive product shell for advanced planner and timeline applications.
TimelineWorkspaceDestination

Enums

StructuredTimelineInitialScroll
TimelineActivityLevel
TimelineConflictType
Conflict categories emitted by TimelineRenderPlan.
TimelineDayNodeKind
TimelineDependencyIssueType
TimelineDependencyType
TimelineDropDisposition
TimelineLayout
Placement strategy for the rail and timeline content.
TimelineOverrideMatch
TimelinePerformanceProfile
TimelinePluginCapability
TimelineQuerySort
TimelineRecurrenceFrequency
TimelineScenarioChangeKind
TimelineSelectionMode
Selection behavior for interactive views.
TimelineSeriesItemKind
TimelineStatus
Stable lifecycle state shared by every 4.x timeline view.
TimelineTimeSemantics
Date normalization policy used by the core engine.
TimelineViewKind
Product-level view modes supported by the timeline platform API.
TimelineVisualStyle
Built-in visual languages. Custom themes remain first-class.

Functions

showTimelineCommandPalette({required BuildContext context, required List<TimelinePaletteCommand> commands, String title = 'Command palette', String hintText = 'Search commands'}) Future<void>

Typedefs

StructuredTimelineCardBuilder<T> = Widget Function(BuildContext context, StructuredTimelineEntryDetails<T> details)
StructuredTimelineConflictBridgeBuilder<T> = Widget Function(BuildContext context, TimelineDayEntry<T> item, Duration overlap, StructuredTimelineStyle style)
StructuredTimelineDeleteTargetBuilder = Widget Function(BuildContext context, bool active, StructuredTimelineStyle style)
StructuredTimelineDragDecorator<T> = Widget Function(BuildContext context, StructuredTimelineEntryDetails<T> details, Widget child)
StructuredTimelineDurationFormatter = String Function(Duration value)
StructuredTimelineEntryCallback<T> = FutureOr<void> Function(BuildContext context, StructuredTimelineEntryDetails<T> details)
StructuredTimelineGapBuilder<T> = Widget Function(BuildContext context, TimelineDayGap<T> gap, StructuredTimelineStyle style)
StructuredTimelineGapCallback<T> = FutureOr<void> Function(BuildContext context, TimelineDayGap<T> gap)
StructuredTimelineGapExtentBuilder<T> = double Function(TimelineDayGap<T> gap, StructuredTimelineStyle style)
Computes the visual extent used for navigation and visibility calculations.
StructuredTimelineIconBuilder<T> = Widget Function(BuildContext context, StructuredTimelineEntryDetails<T> details)
StructuredTimelineInsightBuilder<T> = Widget Function(BuildContext context, TimelineDayPlan<T> plan, StructuredTimelineStyle style)
StructuredTimelineMoveCallback<T> = FutureOr<void> Function(BuildContext context, StructuredTimelineMoveDetails<T> details)
StructuredTimelineProgressBuilder<T> = double? Function(TimelineEntry<T> entry)
StructuredTimelineSubtitleBuilder<T> = String? Function(TimelineEntry<T> entry)
StructuredTimelineTimeFormatter = String Function(DateTime value)
StructuredTimelineTimeLabelBuilder<T> = Widget Function(BuildContext context, TimelineDayEntry<T> item, DateTime value, bool isEnd, StructuredTimelineStyle style)
StructuredTimelineTitleBuilder<T> = String Function(TimelineEntry<T> entry)
StructuredTimelineTrailingBuilder<T> = Widget Function(BuildContext context, StructuredTimelineEntryDetails<T> details)
TimelineAdapterNullableValue<T, R> = R? Function(T value)
TimelineAdapterValue<T, R> = R Function(T value)
TimelineBoardEntryBuilder<T> = Widget Function(BuildContext context, TimelineEntry<T> entry)
TimelineBoardGroupKey<T> = Object Function(TimelineEntry<T> entry)
TimelineBoardGroupLabel = String Function(Object group)
TimelineDayEntryBuilder<T> = Widget Function(BuildContext context, TimelineDayEntryDetails<T> details)
TimelineDependencyNodeBuilder<T> = Widget Function(BuildContext context, TimelineDependencyNodeDetails<T> details)
TimelineEntryBuilder<T> = Widget Function(BuildContext context, TimelineEntryDetails<T> details)
TimelineEntryCallback<T> = void Function(BuildContext context, TimelineEntryDetails<T> details)
TimelineEntryPredicate<T> = bool Function(TimelineEntry<T> entry)
TimelineMoveCallback<T> = FutureOr<void> Function(BuildContext context, TimelineEntryDetails<T> details, DateTime newStart)
TimelineOccurrenceIdBuilder<T> = Object Function(TimelineEntry<T> prototype, int occurrenceIndex, DateTime start)
TimelineOverviewSeek = void Function(DateTime instant)
TimelinePlannerDayWidgetBuilder<T> = Widget Function(BuildContext context, TimelinePlannerDaySnapshot<T> snapshot)
TimelinePlannerWindowWidgetBuilder<T> = Widget Function(BuildContext context, TimelinePlannerWindow<T> window)
TimelineRenderPlanWidgetBuilder<T> = Widget Function(BuildContext context, TimelineRenderPlan<T> plan)
TimelineResourceEntryBuilder<T> = Widget Function(BuildContext context, TimelineResourceEntryDetails<T> details)
TimelineResourceHeaderBuilder = Widget Function(BuildContext context, TimelineResource resource)
TimelineResourceUsageResolver<T> = double Function(TimelineEntry<T> entry, Object resourceId)
TimelineSearchText<T> = String Function(TimelineEntry<T> entry)
TimelineSeriesOccurrenceIdBuilder<T> = Object Function(TimelineSeriesItem<T> base, int occurrenceIndex, DateTime start)