PodCollectionBuilder class

Observes a "source of pods" — a source Listenable whose changes imply that the set of inner pods to watch may have changed — and rebuilds when either:

1. the source fires, or
2. any pod currently returned by innerPods fires.

Subscription lifecycle for the inner pods is managed automatically — when the source changes, the widget re-invokes innerPods, diffs the new set against the current subscriptions by identity, adds new listeners, removes gone ones, and rebuilds.

Example

// `pJobServices` is a pod whose value is a list of services, each
// exposing a `.pData` pod. Rebuild when the list changes OR when any
// listed service's `.pData` fires.
PodCollectionBuilder(
  source: pJobServices,
  innerPods: () => pJobServices.getValue().map((s) => s.pData).toList(),
  builder: (context) => MyList(jobs: resolveCurrentJobs()),
)

Type compatibility

Accepts any Listenable — including Pod (via WeakChangeNotifier) and stock Flutter ValueNotifier/ChangeNotifier. For WeakChangeNotifiers the widget automatically uses addStrongRefListener so the internal tear-off isn't GC'd between fires; for plain Listenables it falls back to addListener.