fluiver 4.0.0

Flutter SDK gap-fillers — scope function, DateTime predicates, listeners, Grid, debounce/throttle. Ships an LLM skill for agent-friendly coding.

Changelog

4.0.0

Strips every API whose job the framework or core libraries already do — fluiver keeps only genuine gaps.

• Removed — AppLifecycleObserver. The framework's AppLifecycleListener is the same wrapper with more granular callbacks: AppLifecycleListener(onStateChange: (s) => ...).

• Removed — DateTime.toTimeOfDay(). Identical to the framework's TimeOfDay.fromDateTime(dt).

• Removed — Map.any / Map.every / Map.firstWhereOrNull. Sugar over map.entries: entries.any((e) => ...), entries.every((e) => ...), and entries.firstWhereOrNull(...) via package:collection.

• Renamed — LocaleObserver → LocaleListener, BrightnessObserver → BrightnessListener, matching the framework's AppLifecycleListener naming.

• Breaking — FlexGrid is now Grid (RenderFlexGrid → RenderGrid), configured by the same SliverGridDelegate family as GridView for DX and agent predictability: Grid(gridDelegate: ...) takes any delegate (custom ones included), Grid.count(...) / Grid.extent(...) mirror GridView.count / GridView.extent. Migrate FlexGrid(crossAxisCount: 3, ...) → Grid.count(crossAxisCount: 3, ...); the delegate's mainAxisExtent overrides childAspectRatio (the GridView contract, replacing the old additive behavior).

• Added — Grid covers what GridView(shrinkWrap: true) cannot: real intrinsics (no hard-coded estimates; unbounded extents shrink-wrap to child intrinsics), exact computeDryLayout and computeDryBaseline, first-child baseline, debugFillProperties, RTL cross-axis reversal matching GridView, a descriptive FlutterError under an unbounded cross axis, and degenerate constraints clamping cells to zero instead of negative.

• Breaking — platformDispatch's macOS parameter is now macos, matching its all-lowercase siblings (android, ios, linux, …) — the name agents and autocomplete-blind humans guess first.

• Breaking — NetworkProbe.hasConnection → checkConnection (verb — it's an async probe, not a cheap property). Gains host/port (default unchanged: 1.0.0.1:53) for self-hosted probe endpoints, its first tests, and the default timeout rises 2s → 3s so a lossy mobile network surviving two SYN retransmits still reports true.

• Changed — RenderGrid and TickerBuilder internals follow framework conventions: getter/field/setter property clusters, delegate relayout via SliverGridDelegate.shouldRelayout, named tick handler created in initState (side effects moved out of the setState closure).

• Changed — unawaited_futures/discarded_futures lints disabled package-wide: fire-and-forget futures in sync lifecycle methods are dropped bare, framework-style; NetworkProbe now awaits socket.close() before reporting reachability.

• Fixed — TextEditingController.setTextAndCaret now clamps caret to 0..text.length instead of producing an out-of-range selection.

• Changed — LRUCache throws ArgumentError for maxEntries <= 0 in all build modes (was a debug-only assert).

• Changed — FastHash.fnv1a iterates code units by index, avoiding an iterator allocation per call.

• Changed — FastHash.fnv1a now runs on Wasm builds (native 64-bit ints there); only JS web throws UnsupportedError.

• Changed — Debounce/Throttle* dispose() drops pending task references (no closure retention), and calling a disposed instance throws FlutterError in debug mode.

• Changed — a Grid given EdgeInsetsDirectional padding with no ambient Directionality now asserts in debug mode (framework behavior) instead of silently resolving as LTR.

• Fixed — an empty Grid's cross-axis intrinsics no longer include phantom crossAxisSpacing; they report padding only.

• Fixed — windowed(0) (and step: 0) now throws RangeError: size: must be > 0 instead of a misleading -1 message.

• Changed — dropped the unused meta dependency.

Kept deliberately, verified against Flutter 3.41 / Dart 3.11: truncateTime() (unlike DateUtils.dateOnly it preserves UTC-ness), windowed (package:collection only has non-overlapping slices), timeoutOrNull (package:async has no equivalent), Map.where/whereKeyType/whereValueType (return a Map, narrow the static type), separated (Flex spacing only covers blank gaps, not separator widgets), byNameOrNull (core's asNameMap()[name] allocates a map per lookup and spells a simple scan sideways).

3.3.0

• Added — ScrollTrackingExpandable widget: animated expand/collapse that keeps the growing bottom edge visible in the nearest Scrollable while expanding, with scrollOffset for extra breathing room below.

3.2.3

• Fixed — SDK compatibility fix in NetworkProbe by replacing type-directed enum shorthand .IPv4 with fully qualified enum reference.
• Fixed — Rescheduling timing bug in ThrottleLatest.
• Fixed — Memory leak in ThrottleLast by clearing callback references post-execution.
• Fixed — Native resource leak in TickerBuilder by disposing of ticker binding resources properly.
• Fixed — Exception safety in DisposableBag to prevent a single failing disposer from blocking subsequent disposers, raising DisposableBagException containing all errors at the end.
• Fixed — Timezone-safety alignment in DateTimeCheck.age() and TimeOfDayOnDate.onDate().
• Added — Intrinsic height and width measurement calculations on FlexGrid's custom RenderBox (RenderFlexGrid).
• Changed — Optimized lookup efficiency in Map.entryOf and generic compile-safety in EnumIndexComparable.

3.2.2

• Fixed — FastHash.fnv1a's 64-bit offset-basis literal broke compilation on web targets (including flutter widget-preview). Now split into web-representable halves (bit-exact on the VM); throws UnsupportedError on web instead of corrupting hashes.

3.2.1

• Changed — Dropped @useResult from Object.let; the result can now be safely ignored (e.g. side-effecting transforms) without an analyzer warning.
• Changed — LLM artifact moved from a path-scoped rule to a description-triggered skill (tool/claude/flutter-fluiver/SKILL.md); loaded by relevance instead of on every lib/ / test/ file.

3.2.0

• Added — LRUCache.putIfAbsent(K key, V Function() ifAbsent). Lazy compute on miss; hit promotes the entry to most-recently-used.
• Added — DisposableBag.addAll(Iterable<FutureOr<void> Function()>). Bulk-register disposers; same semantics as repeated add.
• Changed — Rule file no-overlap callout narrowed to package:collection and package:async.

3.1.0

• Added — Color.darken([amount]), Color.lighten([amount]), Color.contrastText. HSL-based; contrastText picks black or white via luminance.
• Added — ScrollController.atTop, .atBottom, .animateToTop({duration, curve}), .animateToBottom({duration, curve}). hasClients-safe.
• Added — Future<T>.timeoutOrNull(Duration) → Future<T?>. Null on timeout, errors still propagate.
• Added — Iterable<E>.windowed(int size, {int step = 1}). Stepped sliding window; drops partial trailing window.
• Added — TextEditingController.setTextAndCaret(String, {int? caret}). Avoids the controller.text = ... caret-reset papercut.
• Changed — LLM artifact moved from rules/fluiver.md to rules/flutter-fluiver.md. Namespaced with the flutter- prefix.
• Removed — PaddedFlex / PaddedRow / PaddedColumn widgets. Use Padding(padding: ..., child: Column(children: [...])) / Row — LLMs reach for this natively.
• Removed — IterableEnum.byNameOrElse(name, orElse: ...). Use Enum.values.byNameOrNull(name) ?? .fallback — Dart shorthand handles the fallback.

3.0.0

Breaking — utility-library pivot. The "single-dot shortcut" framing collided with LLM-assisted development: agents do not know the extensions exist, default to stdlib forms, and teaching the API costs input tokens on every turn. The sugar layer had to go. What remains is substance — things the SDK is genuinely missing. Ships a compact rule file at rules/fluiver.md for consumer projects to load into their LLM agent.

• Removed — extensions/build_context.dart (context.primaryColor, context.titleLargeTextStyle, context.screenWidth, context.isThemeDark, …). Use Theme.of(context).colorScheme.primary, Theme.of(context).textTheme.titleLarge, MediaQuery.sizeOf(context).width, Theme.of(context).brightness == Brightness.dark.
• Removed — extensions/text_style.dart (withColor, withWeight400, withSize, withUnderline, …). Use style.copyWith(color: ..., fontWeight: FontWeight.w400, fontSize: ...).
• Removed — extensions/edge_insets.dart (addLeft, onlyTop, setRight, withStatusBarMargin, …). Use EdgeInsets.only(...), .copyWith(...), MediaQuery.viewPaddingOf(context).top.
• Removed — extensions/border_radius.dart (addAll, onlyTopLeft, setBottomRight, …). Use BorderRadius.only(...), .copyWith(...).
• Removed — extensions/bool.dart (toInt). Use b ? 1 : 0.
• Removed — extensions/date_time.dart arithmetic (addYears, addMonths, addWeeks, addDays, addHours, addMinutes, addSeconds). Use dt.add(Duration(days: N)) / DateTime(y + n, m, d).
• Removed — extensions/key.dart (validateAndSave on GlobalKey<FormFieldState<T>>). Use if (k.currentState!.validate()) k.currentState!.save();.
• Removed — extensions/flutter_enums.dart (Axis.reverse, TextDirection.reverse, Brightness.reverse, Orientation.reverse). Use inline ternary.
• Removed — extensions/string.dart (capitalize, capitalizeAll, initials, safeSubstring). Inline.
• Renamed — fastHash(s) → FastHash.fnv1a(s). Namespace, algorithm-named, future-proof for other hashes.
• Renamed — hasDeviceConnection() → NetworkProbe.hasConnection({timeout}). Namespaced; timeout is now configurable.
• Renamed — platformSpecific<T>(...) → platformDispatch<T>(...). Clearer name; matches compute / dispatch mental model.
• Renamed — disabledInputCounterBuilder → TextFieldBuilders.disabledCounter. Namespaced; room for more TextField helpers.
• Renamed — TimeOfDay.todayAt() → TimeOfDay.onDate(DateTime date). Takes the calendar day explicitly — testable, no hidden DateTime.now().
• Fixed — Map.entryOf(k) distinguishes "key absent" from "key present with null value"; previously returned null for both. {'a': null}.entryOf('a') now returns MapEntry('a', null).
• Fixed — DateTime.isTomorrow / isYesterday used Duration(days: 1) (24h), which crosses DST fall-back days incorrectly. Now uses calendar-day arithmetic (DateTime(y, m, d ± 1)).
• Fixed — NetworkProbe.hasConnection short-circuits to true on web (previous dart:io.Socket call would have thrown at runtime), narrows its catch to SocketException / TimeoutException (no more swallowing programming bugs), and exposes the timeout as a parameter.
• Fixed — PaddedFlex.textDirection / textBaseline default to null — Flex resolves from ambient Directionality. Previously hardcoded TextDirection.ltr broke RTL layouts.
• Fixed — TickerBuilder.initState calls super.initState() before starting the ticker.
• Fixed — ThrottleLast._last initialized to a no-op closure instead of late VoidCallback.
• Fixed — Let<T> extension is now bounded to T extends Object, so .let no longer pollutes autocomplete on nullable receivers. Use ?.let(...) for null-aware chaining.
• Added — LRUCache<K, V>(maxEntries: N). Bounded least-recently-used cache; O(1) reads / writes / eviction; reads / writes promote.
• Added — DisposableBag. Collect dispose / cancel / close closures and flush in registration order with a single dispose(). Idempotent; adding after dispose runs the closure immediately.
• Added — rules/fluiver.md. Compact rule file for LLM agents; documents the surviving API surface and steers away from removed identifiers.

2.4.3

• Removed StreamWhereType (duplicates dart:async).
• Renamed inToday → todayAt, fixed BuildContextsColorScheme typo.
• Doc fixes.

2.4.2

• Removed is* enum getters; use shorthand comparisons (x == .ltr).
• Improved hasDeviceConnection (socket + timeout).
• Added disabledInputCounterBuilder.

2.4.1

• Broadened SDK constraint to >=3.10.0 <4.0.0.

2.4.0

• Added platformSpecific utility.
• Modernized observers to use PlatformDispatcher.
• Adopted shorthand enum values throughout.
• Fixed ThrottleLast task execution.

2.3.0

• Added index parameter to Iterable.separated.
• Added let scope extension on Object.
• Renamed deviceHasConnection → hasDeviceConnection.
• Added fastHash.

2.2.0

• Removed Iterable extensions that duplicate package:collection.
• Renamed Iterable.separate → Iterable.separated.

2.1.0

• Added PaddedFlex, PaddedRow, PaddedColumn.

2.0.0

• Breaking: FlexGrid rewritten as MultiChildRenderObjectWidget.
• Added FlexGrid.padding, all M3 ColorScheme context getters.
• Removed BezierSquircleBorder. Min SDK Dart 3.0.0.

1.2.0

• Added ColorScheme context getters, BezierSquircleBorder, StreamWhereType.

1.1.1

• Added TickerBuilder.onTick.

1.1.0

• Added TickerBuilder.

1.0.1

• Updated MediaQuery lookups; removed elementAtOrNull, singleOrNull (now in core).

1.0.0

• Initial release.