Expand barback's notion of dirtiness to understand declaredness.

pkg/barback/lib/src/asset_cascade.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 library barback.asset_cascade;
 
 import 'dart:async';
 
 import 'asset.dart';
 import 'asset_id.dart';
 import 'asset_node.dart';
 import 'asset_set.dart';
-import 'log.dart';
 import 'cancelable_future.dart';
 import 'errors.dart';
+import 'log.dart';
+import 'node_status.dart';
 import 'node_streams.dart';
 import 'package_graph.dart';
 import 'phase.dart';
 import 'transformer.dart';
 
 /// The asset cascade for an individual package.
 ///
 /// This keeps track of which [Transformer]s are applied to which assets, and
 /// re-runs those transformers when their dependencies change. The transformed
 /// asset nodes are accessible via [getAssetNode].
@@ skipping 22 matching lines @@
   /// one.
   final _loadingSources = new Map<AssetId, CancelableFuture<Asset>>();
 
   /// The list of phases in this cascade.
   ///
   /// This will always contain at least one phase, and the first phase will
   /// never have any transformers. This ensures that every transformer can
   /// request inputs from a previous phase.
   final _phases = <Phase>[];
 
-  /// The subscription to the [Phase.onDone] stream of the last [Phase] in
-  /// [_phases].
-  StreamSubscription _phaseOnDoneSubscription;
+  /// The subscription to the [Phase.onStatusChange] stream of the last [Phase]
+  /// in [_phases].
+  StreamSubscription _phaseStatusSubscription;
 
   /// A stream that emits any errors from the cascade or the transformers.
   ///
   /// This emits errors as they're detected. If an error occurs in one part of
   /// the cascade, unrelated parts will continue building.
   Stream<BarbackException> get errors => _errorsController.stream;
   final _errorsController =
       new StreamController<BarbackException>.broadcast(sync: true);
 
-  /// Whether [this] is dirty and still has more processing to do.
-  bool get isDirty {
+  /// How far along [this] is in processing its assets.
+  NodeStatus get status {
     // Just check the last phase, since it will check all the previous phases
     // itself.
-    return _phases.last.isDirty;
+    return _phases.last.status;
   }
 
   /// The streams exposed by this cascade.
   final _streams = new NodeStreams();
   Stream<LogEntry> get onLog => _streams.onLog;
-  Stream get onDone => _streams.onDone;
+  Stream<NodeStatus> get onStatusChange => _streams.onStatusChange;
 
   /// Returns all currently-available output assets from this cascade.
   AssetSet get availableOutputs =>
     new AssetSet.from(_phases.last.availableOutputs.map((node) => node.asset));
 
   /// Creates a new [AssetCascade].
   ///
   /// It loads source assets within [package] using [provider].
   AssetCascade(this.graph, this.package) {
     _addPhase(new Phase(this, package));
@@ skipping 92 matching lines @@
       var phase = _phases.last.addPhase();
       _addPhase(phase);
       phase.updateTransformers(transformers[i]);
     }
 
     for (var i = transformers.length + 1; i < _phases.length; i++) {
       _phases[i].remove();
     }
     _phases.removeRange(transformers.length + 1, _phases.length);
 
-    _phaseOnDoneSubscription.cancel();
-    _phaseOnDoneSubscription = _phases.last.onDone
-        .listen(_streams.onDoneController.add);
+    _phaseStatusSubscription.cancel();
+    _phaseStatusSubscription = _phases.last.onStatusChange
+        .listen(_streams.changeStatus);
   }
 
   /// Force all [LazyTransformer]s' transforms in this cascade to begin
   /// producing concrete assets.
   void forceAllTransforms() {
     for (var phase in _phases) {
       phase.forceAllTransforms();
     }
   }
 
   void reportError(BarbackException error) {
     _errorsController.add(error);
   }
 
   /// Add [phase] to the end of [_phases] and watch its streams.
   void _addPhase(Phase phase) {
     _streams.onLogPool.add(phase.onLog);
-    if (_phaseOnDoneSubscription != null) _phaseOnDoneSubscription.cancel();
-    _phaseOnDoneSubscription =
-        phase.onDone.listen(_streams.onDoneController.add);
+    if (_phaseStatusSubscription != null) _phaseStatusSubscription.cancel();
+    _phaseStatusSubscription =
+        phase.onStatusChange.listen(_streams.changeStatus);
 
     _phases.add(phase);
   }
 
   String toString() => "cascade for $package";
 }