Expand barback's notion of dirtiness to understand declaredness.

pkg/barback/lib/src/asset_node.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_node;
 
 import 'dart:async';
 
 import 'asset.dart';
 import 'asset_id.dart';
@@ skipping 104 matching lines @@
   /// [callback] is called synchronously if this is already in such a state.
   ///
   /// The return value of [callback] is piped to the returned Future.
   Future _waitForState(bool test(AssetState state),
       callback(AssetState state)) {
     if (test(state)) return syncFuture(() => callback(state));
     return onStateChange.firstWhere(test).then((_) => callback(state));
   }
 
   AssetNode._(this.id, this._transform, this._origin)
-      : _state = AssetState.DIRTY;
+      : _state = AssetState.RUNNING;
 
   AssetNode._available(Asset asset, this._transform, this._origin)
       : id = asset.id,
         _asset = asset,
         _state = AssetState.AVAILABLE;
 
   AssetNode._lazy(this.id, this._transform, this._origin, this._lazyCallback)
-      : _state = AssetState.DIRTY;
+      : _state = AssetState.RUNNING;
 
   /// If [this] is lazy, force it to generate a concrete asset; otherwise, do
   /// nothing.
   ///
   /// See [AssetNodeController.lazy].
   void force() {
     if (_origin != null) {
       _origin.force();
     } else if (_lazyCallback != null) {
       _lazyCallback();
@@ skipping 42 matching lines @@
   /// If [node] is lazy, the returned node will also be lazy.
   AssetNodeController.from(AssetNode node)
       : node = new AssetNode._(node.id, node.transform, node.origin) {
     if (node.state.isAvailable) {
       setAvailable(node.asset);
     } else if (node.state.isRemoved) {
       setRemoved();
     }
   }
 
-  /// Marks the node as [AssetState.DIRTY].
+  /// Marks the node as [AssetState.RUNNING].
   void setDirty() {
     assert(node._state != AssetState.REMOVED);
     node._asset = null;
     node._lazyCallback = null;
 
     // Don't re-emit a dirty event to avoid cases where we try to dispatch an
     // event while handling another event (e.g. an output is marked lazy, which
     // causes it to be forced, which causes it to be marked dirty).
     if (node._state.isDirty) return;
-    node._state = AssetState.DIRTY;
-    node._stateChangeController.add(AssetState.DIRTY);
+    node._state = AssetState.RUNNING;
+    node._stateChangeController.add(AssetState.RUNNING);
   }
 
   /// Marks the node as [AssetState.REMOVED].
   ///
   /// Once a node is marked as removed, it can't be marked as any other state.
   /// If a new asset is created with the same id, it will get a new node.
   void setRemoved() {
     assert(node._state != AssetState.REMOVED);
     node._state = AssetState.REMOVED;
     node._asset = null;
     node._lazyCallback = null;
     node._stateChangeController.add(AssetState.REMOVED);
   }
 
   /// Marks the node as [AssetState.AVAILABLE] with the given concrete [asset].
   ///
   /// It's an error to mark an already-available node as available. It should be
   /// marked as dirty first.
   void setAvailable(Asset asset) {
     assert(asset.id == node.id);
     assert(node._state != AssetState.REMOVED);
     assert(node._state != AssetState.AVAILABLE);
     node._state = AssetState.AVAILABLE;
     node._asset = asset;
     node._lazyCallback = null;
     node._stateChangeController.add(AssetState.AVAILABLE);
   }
 
-  /// Marks the node as [AssetState.DIRTY] and lazy.
+  /// Marks the node as [AssetState.RUNNING] and lazy.
   ///
   /// Lazy nodes aren't expected to have their values generated until needed.
   /// Once it's necessary, [callback] will be called. [callback] is guaranteed
   /// to be called only once.
   ///
   /// See also [AssetNodeController.lazy].
   void setLazy(void callback()) {
     assert(node._state != AssetState.REMOVED);
-    node._state = AssetState.DIRTY;
+    node._state = AssetState.RUNNING;
     node._asset = null;
     node._lazyCallback = callback;
-    node._stateChangeController.add(AssetState.DIRTY);
+    node._stateChangeController.add(AssetState.RUNNING);
   }
 
   String toString() => "controller for $node";
 }
 
 // TODO(nweiz): add an error state.
 /// An enum of states that an [AssetNode] can be in.
 class AssetState {
   /// The node has a concrete asset loaded, available, and up-to-date. The asset
   /// is accessible via [AssetNode.asset]. An asset can only be marked available
-  /// again from the [AssetState.DIRTY] state.
+  /// again from the [AssetState.RUNNING] state.
   static final AVAILABLE = const AssetState._("available");
 
   /// The asset is no longer available, possibly for good. A removed asset will
   /// never enter another state.
   static final REMOVED = const AssetState._("removed");
 
   /// The asset will exist in the future (unless it's removed), but the concrete
   /// asset is not yet available.
-  static final DIRTY = const AssetState._("dirty");
+  static final RUNNING = const AssetState._("dirty");
 
   /// Whether this state is [AssetState.AVAILABLE].
   bool get isAvailable => this == AssetState.AVAILABLE;
 
   /// Whether this state is [AssetState.REMOVED].
   bool get isRemoved => this == AssetState.REMOVED;
 
-  /// Whether this state is [AssetState.DIRTY].
-  bool get isDirty => this == AssetState.DIRTY;
+  /// Whether this state is [AssetState.RUNNING].
+  bool get isDirty => this == AssetState.RUNNING;
 
   final String name;
 
   const AssetState._(this.name);
 
   String toString() => name;
 }