tor-browser

The Tor Browser
git clone https://git.dasho.dev/tor-browser.git
Log | Files | Refs | README | LICENSE

check-deltablue.js (25593B)


      1 // Copyright 2008 the V8 project authors. All rights reserved.
      2 // Copyright 1996 John Maloney and Mario Wolczko.
      3 
      4 // This program is free software; you can redistribute it and/or modify
      5 // it under the terms of the GNU General Public License as published by
      6 // the Free Software Foundation; either version 2 of the License, or
      7 // (at your option) any later version.
      8 //
      9 // This program is distributed in the hope that it will be useful,
     10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
     11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     12 // GNU General Public License for more details.
     13 //
     14 // You should have received a copy of the GNU General Public License
     15 // along with this program; if not, write to the Free Software
     16 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
     17 
     18 
     19 // This implementation of the DeltaBlue benchmark is derived
     20 // from the Smalltalk implementation by John Maloney and Mario
     21 // Wolczko. Some parts have been translated directly, whereas
     22 // others have been modified more aggresively to make it feel
     23 // more like a JavaScript program.
     24 
     25 
     26 //var DeltaBlue = new BenchmarkSuite('DeltaBlue', 71104, [
     27 //  new Benchmark('DeltaBlue', deltaBlue)
     28 //]);
     29 
     30 
     31 /**
     32 * A JavaScript implementation of the DeltaBlue constrain-solving
     33 * algorithm, as described in:
     34 *
     35 * "The DeltaBlue Algorithm: An Incremental Constraint Hierarchy Solver"
     36 *   Bjorn N. Freeman-Benson and John Maloney
     37 *   January 1990 Communications of the ACM,
     38 *   also available as University of Washington TR 89-08-06.
     39 *
     40 * Beware: this benchmark is written in a grotesque style where
     41 * the constraint model is built by side-effects from constructors.
     42 * I've kept it this way to avoid deviating too much from the original
     43 * implementation.
     44 */
     45 
     46 function alert(msg) {
     47    print(msg);
     48    assertEq(false, true);
     49 }
     50 
     51 /* --- O b j e c t   M o d e l --- */
     52 
     53 Object.prototype.inheritsFrom = function (shuper) {
     54  function Inheriter() { }
     55  Inheriter.prototype = shuper.prototype;
     56  this.prototype = new Inheriter();
     57  this.superConstructor = shuper;
     58 }
     59 
     60 function OrderedCollection() {
     61  this.elms = new Array();
     62 }
     63 
     64 OrderedCollection.prototype.add = function (elm) {
     65  this.elms.push(elm);
     66 }
     67 
     68 OrderedCollection.prototype.at = function (index) {
     69  return this.elms[index];
     70 }
     71 
     72 OrderedCollection.prototype.size = function () {
     73  return this.elms.length;
     74 }
     75 
     76 OrderedCollection.prototype.removeFirst = function () {
     77  return this.elms.pop();
     78 }
     79 
     80 OrderedCollection.prototype.remove = function (elm) {
     81  var index = 0, skipped = 0;
     82  for (var i = 0; i < this.elms.length; i++) {
     83    var value = this.elms[i];
     84    if (value != elm) {
     85      this.elms[index] = value;
     86      index++;
     87    } else {
     88      skipped++;
     89    }
     90  }
     91  for (var i = 0; i < skipped; i++)
     92    this.elms.pop();
     93 }
     94 
     95 /* --- *
     96 * S t r e n g t h
     97 * --- */
     98 
     99 /**
    100 * Strengths are used to measure the relative importance of constraints.
    101 * New strengths may be inserted in the strength hierarchy without
    102 * disrupting current constraints.  Strengths cannot be created outside
    103 * this class, so pointer comparison can be used for value comparison.
    104 */
    105 function Strength(strengthValue, name) {
    106  this.strengthValue = strengthValue;
    107  this.name = name;
    108 }
    109 
    110 Strength.stronger = function (s1, s2) {
    111  return s1.strengthValue < s2.strengthValue;
    112 }
    113 
    114 Strength.weaker = function (s1, s2) {
    115  return s1.strengthValue > s2.strengthValue;
    116 }
    117 
    118 Strength.weakestOf = function (s1, s2) {
    119  return this.weaker(s1, s2) ? s1 : s2;
    120 }
    121 
    122 Strength.strongest = function (s1, s2) {
    123  return this.stronger(s1, s2) ? s1 : s2;
    124 }
    125 
    126 Strength.prototype.nextWeaker = function () {
    127  switch (this.strengthValue) {
    128    case 0: return Strength.WEAKEST;
    129    case 1: return Strength.WEAK_DEFAULT;
    130    case 2: return Strength.NORMAL;
    131    case 3: return Strength.STRONG_DEFAULT;
    132    case 4: return Strength.PREFERRED;
    133    case 5: return Strength.REQUIRED;
    134  }
    135 }
    136 
    137 // Strength constants.
    138 Strength.REQUIRED        = new Strength(0, "required");
    139 Strength.STONG_PREFERRED = new Strength(1, "strongPreferred");
    140 Strength.PREFERRED       = new Strength(2, "preferred");
    141 Strength.STRONG_DEFAULT  = new Strength(3, "strongDefault");
    142 Strength.NORMAL          = new Strength(4, "normal");
    143 Strength.WEAK_DEFAULT    = new Strength(5, "weakDefault");
    144 Strength.WEAKEST         = new Strength(6, "weakest");
    145 
    146 /* --- *
    147 * C o n s t r a i n t
    148 * --- */
    149 
    150 /**
    151 * An abstract class representing a system-maintainable relationship
    152 * (or "constraint") between a set of variables. A constraint supplies
    153 * a strength instance variable; concrete subclasses provide a means
    154 * of storing the constrained variables and other information required
    155 * to represent a constraint.
    156 */
    157 function Constraint(strength) {
    158  this.strength = strength;
    159 }
    160 
    161 /**
    162 * Activate this constraint and attempt to satisfy it.
    163 */
    164 Constraint.prototype.addConstraint = function () {
    165  this.addToGraph();
    166  planner.incrementalAdd(this);
    167 }
    168 
    169 /**
    170 * Attempt to find a way to enforce this constraint. If successful,
    171 * record the solution, perhaps modifying the current dataflow
    172 * graph. Answer the constraint that this constraint overrides, if
    173 * there is one, or nil, if there isn't.
    174 * Assume: I am not already satisfied.
    175 */
    176 Constraint.prototype.satisfy = function (mark) {
    177  this.chooseMethod(mark);
    178  if (!this.isSatisfied()) {
    179    if (this.strength == Strength.REQUIRED)
    180      alert("Could not satisfy a required constraint!");
    181    return null;
    182  }
    183  this.markInputs(mark);
    184  var out = this.output();
    185  var overridden = out.determinedBy;
    186  if (overridden != null) overridden.markUnsatisfied();
    187  out.determinedBy = this;
    188  if (!planner.addPropagate(this, mark))
    189    alert("Cycle encountered");
    190  out.mark = mark;
    191  return overridden;
    192 }
    193 
    194 Constraint.prototype.destroyConstraint = function () {
    195  if (this.isSatisfied()) planner.incrementalRemove(this);
    196  else this.removeFromGraph();
    197 }
    198 
    199 /**
    200 * Normal constraints are not input constraints.  An input constraint
    201 * is one that depends on external state, such as the mouse, the
    202 * keybord, a clock, or some arbitraty piece of imperative code.
    203 */
    204 Constraint.prototype.isInput = function () {
    205  return false;
    206 }
    207 
    208 /* --- *
    209 * U n a r y   C o n s t r a i n t
    210 * --- */
    211 
    212 /**
    213 * Abstract superclass for constraints having a single possible output
    214 * variable.
    215 */
    216 function UnaryConstraint(v, strength) {
    217  UnaryConstraint.superConstructor.call(this, strength);
    218  this.myOutput = v;
    219  this.satisfied = false;
    220  this.addConstraint();
    221 }
    222 
    223 UnaryConstraint.inheritsFrom(Constraint);
    224 
    225 /**
    226 * Adds this constraint to the constraint graph
    227 */
    228 UnaryConstraint.prototype.addToGraph = function () {
    229  this.myOutput.addConstraint(this);
    230  this.satisfied = false;
    231 }
    232 
    233 /**
    234 * Decides if this constraint can be satisfied and records that
    235 * decision.
    236 */
    237 UnaryConstraint.prototype.chooseMethod = function (mark) {
    238  this.satisfied = (this.myOutput.mark != mark)
    239    && Strength.stronger(this.strength, this.myOutput.walkStrength);
    240 }
    241 
    242 /**
    243 * Returns true if this constraint is satisfied in the current solution.
    244 */
    245 UnaryConstraint.prototype.isSatisfied = function () {
    246  return this.satisfied;
    247 }
    248 
    249 UnaryConstraint.prototype.markInputs = function (mark) {
    250  // has no inputs
    251 }
    252 
    253 /**
    254 * Returns the current output variable.
    255 */
    256 UnaryConstraint.prototype.output = function () {
    257  return this.myOutput;
    258 }
    259 
    260 /**
    261 * Calculate the walkabout strength, the stay flag, and, if it is
    262 * 'stay', the value for the current output of this constraint. Assume
    263 * this constraint is satisfied.
    264 */
    265 UnaryConstraint.prototype.recalculate = function () {
    266  this.myOutput.walkStrength = this.strength;
    267  this.myOutput.stay = !this.isInput();
    268  if (this.myOutput.stay) this.execute(); // Stay optimization
    269 }
    270 
    271 /**
    272 * Records that this constraint is unsatisfied
    273 */
    274 UnaryConstraint.prototype.markUnsatisfied = function () {
    275  this.satisfied = false;
    276 }
    277 
    278 UnaryConstraint.prototype.inputsKnown = function () {
    279  return true;
    280 }
    281 
    282 UnaryConstraint.prototype.removeFromGraph = function () {
    283  if (this.myOutput != null) this.myOutput.removeConstraint(this);
    284  this.satisfied = false;
    285 }
    286 
    287 /* --- *
    288 * S t a y   C o n s t r a i n t
    289 * --- */
    290 
    291 /**
    292 * Variables that should, with some level of preference, stay the same.
    293 * Planners may exploit the fact that instances, if satisfied, will not
    294 * change their output during plan execution.  This is called "stay
    295 * optimization".
    296 */
    297 function StayConstraint(v, str) {
    298  StayConstraint.superConstructor.call(this, v, str);
    299 }
    300 
    301 StayConstraint.inheritsFrom(UnaryConstraint);
    302 
    303 StayConstraint.prototype.execute = function () {
    304  // Stay constraints do nothing
    305 }
    306 
    307 /* --- *
    308 * E d i t   C o n s t r a i n t
    309 * --- */
    310 
    311 /**
    312 * A unary input constraint used to mark a variable that the client
    313 * wishes to change.
    314 */
    315 function EditConstraint(v, str) {
    316  EditConstraint.superConstructor.call(this, v, str);
    317 }
    318 
    319 EditConstraint.inheritsFrom(UnaryConstraint);
    320 
    321 /**
    322 * Edits indicate that a variable is to be changed by imperative code.
    323 */
    324 EditConstraint.prototype.isInput = function () {
    325  return true;
    326 }
    327 
    328 EditConstraint.prototype.execute = function () {
    329  // Edit constraints do nothing
    330 }
    331 
    332 /* --- *
    333 * B i n a r y   C o n s t r a i n t
    334 * --- */
    335 
    336 var Direction = new Object();
    337 Direction.NONE     = 0;
    338 Direction.FORWARD  = 1;
    339 Direction.BACKWARD = -1;
    340 
    341 /**
    342 * Abstract superclass for constraints having two possible output
    343 * variables.
    344 */
    345 function BinaryConstraint(var1, var2, strength) {
    346  BinaryConstraint.superConstructor.call(this, strength);
    347  this.v1 = var1;
    348  this.v2 = var2;
    349  this.direction = Direction.NONE;
    350  this.addConstraint();
    351 }
    352 
    353 BinaryConstraint.inheritsFrom(Constraint);
    354 
    355 /**
    356 * Decides if this constratint can be satisfied and which way it
    357 * should flow based on the relative strength of the variables related,
    358 * and record that decision.
    359 */
    360 BinaryConstraint.prototype.chooseMethod = function (mark) {
    361  if (this.v1.mark == mark) {
    362    this.direction = (this.v1.mark != mark && Strength.stronger(this.strength, this.v2.walkStrength))
    363      ? Direction.FORWARD
    364      : Direction.NONE;
    365  }
    366  if (this.v2.mark == mark) {
    367    this.direction = (this.v1.mark != mark && Strength.stronger(this.strength, this.v1.walkStrength))
    368      ? Direction.BACKWARD
    369      : Direction.NONE;
    370  }
    371  if (Strength.weaker(this.v1.walkStrength, this.v2.walkStrength)) {
    372    this.direction = Strength.stronger(this.strength, this.v1.walkStrength)
    373      ? Direction.BACKWARD
    374      : Direction.NONE;
    375  } else {
    376    this.direction = Strength.stronger(this.strength, this.v2.walkStrength)
    377      ? Direction.FORWARD
    378      : Direction.BACKWARD
    379  }
    380 }
    381 
    382 /**
    383 * Add this constraint to the constraint graph
    384 */
    385 BinaryConstraint.prototype.addToGraph = function () {
    386  this.v1.addConstraint(this);
    387  this.v2.addConstraint(this);
    388  this.direction = Direction.NONE;
    389 }
    390 
    391 /**
    392 * Answer true if this constraint is satisfied in the current solution.
    393 */
    394 BinaryConstraint.prototype.isSatisfied = function () {
    395  return this.direction != Direction.NONE;
    396 }
    397 
    398 /**
    399 * Mark the input variable with the given mark.
    400 */
    401 BinaryConstraint.prototype.markInputs = function (mark) {
    402  this.input().mark = mark;
    403 }
    404 
    405 /**
    406 * Returns the current input variable
    407 */
    408 BinaryConstraint.prototype.input = function () {
    409  return (this.direction == Direction.FORWARD) ? this.v1 : this.v2;
    410 }
    411 
    412 /**
    413 * Returns the current output variable
    414 */
    415 BinaryConstraint.prototype.output = function () {
    416  return (this.direction == Direction.FORWARD) ? this.v2 : this.v1;
    417 }
    418 
    419 /**
    420 * Calculate the walkabout strength, the stay flag, and, if it is
    421 * 'stay', the value for the current output of this
    422 * constraint. Assume this constraint is satisfied.
    423 */
    424 BinaryConstraint.prototype.recalculate = function () {
    425  var ihn = this.input(), out = this.output();
    426  out.walkStrength = Strength.weakestOf(this.strength, ihn.walkStrength);
    427  out.stay = ihn.stay;
    428  if (out.stay) this.execute();
    429 }
    430 
    431 /**
    432 * Record the fact that this constraint is unsatisfied.
    433 */
    434 BinaryConstraint.prototype.markUnsatisfied = function () {
    435  this.direction = Direction.NONE;
    436 }
    437 
    438 BinaryConstraint.prototype.inputsKnown = function (mark) {
    439  var i = this.input();
    440  return i.mark == mark || i.stay || i.determinedBy == null;
    441 }
    442 
    443 BinaryConstraint.prototype.removeFromGraph = function () {
    444  if (this.v1 != null) this.v1.removeConstraint(this);
    445  if (this.v2 != null) this.v2.removeConstraint(this);
    446  this.direction = Direction.NONE;
    447 }
    448 
    449 /* --- *
    450 * S c a l e   C o n s t r a i n t
    451 * --- */
    452 
    453 /**
    454 * Relates two variables by the linear scaling relationship: "v2 =
    455 * (v1 * scale) + offset". Either v1 or v2 may be changed to maintain
    456 * this relationship but the scale factor and offset are considered
    457 * read-only.
    458 */
    459 function ScaleConstraint(src, scale, offset, dest, strength) {
    460  this.direction = Direction.NONE;
    461  this.scale = scale;
    462  this.offset = offset;
    463  ScaleConstraint.superConstructor.call(this, src, dest, strength);
    464 }
    465 
    466 ScaleConstraint.inheritsFrom(BinaryConstraint);
    467 
    468 /**
    469 * Adds this constraint to the constraint graph.
    470 */
    471 ScaleConstraint.prototype.addToGraph = function () {
    472  ScaleConstraint.superConstructor.prototype.addToGraph.call(this);
    473  this.scale.addConstraint(this);
    474  this.offset.addConstraint(this);
    475 }
    476 
    477 ScaleConstraint.prototype.removeFromGraph = function () {
    478  ScaleConstraint.superConstructor.prototype.removeFromGraph.call(this);
    479  if (this.scale != null) this.scale.removeConstraint(this);
    480  if (this.offset != null) this.offset.removeConstraint(this);
    481 }
    482 
    483 ScaleConstraint.prototype.markInputs = function (mark) {
    484  ScaleConstraint.superConstructor.prototype.markInputs.call(this, mark);
    485  this.scale.mark = this.offset.mark = mark;
    486 }
    487 
    488 /**
    489 * Enforce this constraint. Assume that it is satisfied.
    490 */
    491 ScaleConstraint.prototype.execute = function () {
    492  if (this.direction == Direction.FORWARD) {
    493    this.v2.value = this.v1.value * this.scale.value + this.offset.value;
    494  } else {
    495    this.v1.value = (this.v2.value - this.offset.value) / this.scale.value;
    496  }
    497 }
    498 
    499 /**
    500 * Calculate the walkabout strength, the stay flag, and, if it is
    501 * 'stay', the value for the current output of this constraint. Assume
    502 * this constraint is satisfied.
    503 */
    504 ScaleConstraint.prototype.recalculate = function () {
    505  var ihn = this.input(), out = this.output();
    506  out.walkStrength = Strength.weakestOf(this.strength, ihn.walkStrength);
    507  out.stay = ihn.stay && this.scale.stay && this.offset.stay;
    508  if (out.stay) this.execute();
    509 }
    510 
    511 /* --- *
    512 * E q u a l i t  y   C o n s t r a i n t
    513 * --- */
    514 
    515 /**
    516 * Constrains two variables to have the same value.
    517 */
    518 function EqualityConstraint(var1, var2, strength) {
    519  EqualityConstraint.superConstructor.call(this, var1, var2, strength);
    520 }
    521 
    522 EqualityConstraint.inheritsFrom(BinaryConstraint);
    523 
    524 /**
    525 * Enforce this constraint. Assume that it is satisfied.
    526 */
    527 EqualityConstraint.prototype.execute = function () {
    528  this.output().value = this.input().value;
    529 }
    530 
    531 /* --- *
    532 * V a r i a b l e
    533 * --- */
    534 
    535 /**
    536 * A constrained variable. In addition to its value, it maintain the
    537 * structure of the constraint graph, the current dataflow graph, and
    538 * various parameters of interest to the DeltaBlue incremental
    539 * constraint solver.
    540 **/
    541 function Variable(name, initialValue) {
    542  this.value = initialValue || 0;
    543  this.constraints = new OrderedCollection();
    544  this.determinedBy = null;
    545  this.mark = 0;
    546  this.walkStrength = Strength.WEAKEST;
    547  this.stay = true;
    548  this.name = name;
    549 }
    550 
    551 /**
    552 * Add the given constraint to the set of all constraints that refer
    553 * this variable.
    554 */
    555 Variable.prototype.addConstraint = function (c) {
    556  this.constraints.add(c);
    557 }
    558 
    559 /**
    560 * Removes all traces of c from this variable.
    561 */
    562 Variable.prototype.removeConstraint = function (c) {
    563  this.constraints.remove(c);
    564  if (this.determinedBy == c) this.determinedBy = null;
    565 }
    566 
    567 /* --- *
    568 * P l a n n e r
    569 * --- */
    570 
    571 /**
    572 * The DeltaBlue planner
    573 */
    574 function Planner() {
    575  this.currentMark = 0;
    576 }
    577 
    578 /**
    579 * Attempt to satisfy the given constraint and, if successful,
    580 * incrementally update the dataflow graph.  Details: If satifying
    581 * the constraint is successful, it may override a weaker constraint
    582 * on its output. The algorithm attempts to resatisfy that
    583 * constraint using some other method. This process is repeated
    584 * until either a) it reaches a variable that was not previously
    585 * determined by any constraint or b) it reaches a constraint that
    586 * is too weak to be satisfied using any of its methods. The
    587 * variables of constraints that have been processed are marked with
    588 * a unique mark value so that we know where we've been. This allows
    589 * the algorithm to avoid getting into an infinite loop even if the
    590 * constraint graph has an inadvertent cycle.
    591 */
    592 Planner.prototype.incrementalAdd = function (c) {
    593  var mark = this.newMark();
    594  var overridden = c.satisfy(mark);
    595  while (overridden != null)
    596    overridden = overridden.satisfy(mark);
    597 }
    598 
    599 /**
    600 * Entry point for retracting a constraint. Remove the given
    601 * constraint and incrementally update the dataflow graph.
    602 * Details: Retracting the given constraint may allow some currently
    603 * unsatisfiable downstream constraint to be satisfied. We therefore collect
    604 * a list of unsatisfied downstream constraints and attempt to
    605 * satisfy each one in turn. This list is traversed by constraint
    606 * strength, strongest first, as a heuristic for avoiding
    607 * unnecessarily adding and then overriding weak constraints.
    608 * Assume: c is satisfied.
    609 */
    610 Planner.prototype.incrementalRemove = function (c) {
    611  var out = c.output();
    612  c.markUnsatisfied();
    613  c.removeFromGraph();
    614  var unsatisfied = this.removePropagateFrom(out);
    615  var strength = Strength.REQUIRED;
    616  do {
    617    for (var i = 0; i < unsatisfied.size(); i++) {
    618      var u = unsatisfied.at(i);
    619      if (u.strength == strength)
    620        this.incrementalAdd(u);
    621    }
    622    strength = strength.nextWeaker();
    623  } while (strength != Strength.WEAKEST);
    624 }
    625 
    626 /**
    627 * Select a previously unused mark value.
    628 */
    629 Planner.prototype.newMark = function () {
    630  return ++this.currentMark;
    631 }
    632 
    633 /**
    634 * Extract a plan for resatisfaction starting from the given source
    635 * constraints, usually a set of input constraints. This method
    636 * assumes that stay optimization is desired; the plan will contain
    637 * only constraints whose output variables are not stay. Constraints
    638 * that do no computation, such as stay and edit constraints, are
    639 * not included in the plan.
    640 * Details: The outputs of a constraint are marked when it is added
    641 * to the plan under construction. A constraint may be appended to
    642 * the plan when all its input variables are known. A variable is
    643 * known if either a) the variable is marked (indicating that has
    644 * been computed by a constraint appearing earlier in the plan), b)
    645 * the variable is 'stay' (i.e. it is a constant at plan execution
    646 * time), or c) the variable is not determined by any
    647 * constraint. The last provision is for past states of history
    648 * variables, which are not stay but which are also not computed by
    649 * any constraint.
    650 * Assume: sources are all satisfied.
    651 */
    652 Planner.prototype.makePlan = function (sources) {
    653  var mark = this.newMark();
    654  var plan = new Plan();
    655  var todo = sources;
    656  while (todo.size() > 0) {
    657    var c = todo.removeFirst();
    658    if (c.output().mark != mark && c.inputsKnown(mark)) {
    659      plan.addConstraint(c);
    660      c.output().mark = mark;
    661      this.addConstraintsConsumingTo(c.output(), todo);
    662    }
    663  }
    664  return plan;
    665 }
    666 
    667 /**
    668 * Extract a plan for resatisfying starting from the output of the
    669 * given constraints, usually a set of input constraints.
    670 */
    671 Planner.prototype.extractPlanFromConstraints = function (constraints) {
    672  var sources = new OrderedCollection();
    673  for (var i = 0; i < constraints.size(); i++) {
    674    var c = constraints.at(i);
    675    if (c.isInput() && c.isSatisfied())
    676      // not in plan already and eligible for inclusion
    677      sources.add(c);
    678  }
    679  return this.makePlan(sources);
    680 }
    681 
    682 /**
    683 * Recompute the walkabout strengths and stay flags of all variables
    684 * downstream of the given constraint and recompute the actual
    685 * values of all variables whose stay flag is true. If a cycle is
    686 * detected, remove the given constraint and answer
    687 * false. Otherwise, answer true.
    688 * Details: Cycles are detected when a marked variable is
    689 * encountered downstream of the given constraint. The sender is
    690 * assumed to have marked the inputs of the given constraint with
    691 * the given mark. Thus, encountering a marked node downstream of
    692 * the output constraint means that there is a path from the
    693 * constraint's output to one of its inputs.
    694 */
    695 Planner.prototype.addPropagate = function (c, mark) {
    696  var todo = new OrderedCollection();
    697  todo.add(c);
    698  while (todo.size() > 0) {
    699    var d = todo.removeFirst();
    700    if (d.output().mark == mark) {
    701      this.incrementalRemove(c);
    702      return false;
    703    }
    704    d.recalculate();
    705    this.addConstraintsConsumingTo(d.output(), todo);
    706  }
    707  return true;
    708 }
    709 
    710 
    711 /**
    712 * Update the walkabout strengths and stay flags of all variables
    713 * downstream of the given constraint. Answer a collection of
    714 * unsatisfied constraints sorted in order of decreasing strength.
    715 */
    716 Planner.prototype.removePropagateFrom = function (out) {
    717  out.determinedBy = null;
    718  out.walkStrength = Strength.WEAKEST;
    719  out.stay = true;
    720  var unsatisfied = new OrderedCollection();
    721  var todo = new OrderedCollection();
    722  todo.add(out);
    723  while (todo.size() > 0) {
    724    var v = todo.removeFirst();
    725    for (var i = 0; i < v.constraints.size(); i++) {
    726      var c = v.constraints.at(i);
    727      if (!c.isSatisfied())
    728        unsatisfied.add(c);
    729    }
    730    var determining = v.determinedBy;
    731    for (var i = 0; i < v.constraints.size(); i++) {
    732      var next = v.constraints.at(i);
    733      if (next != determining && next.isSatisfied()) {
    734        next.recalculate();
    735        todo.add(next.output());
    736      }
    737    }
    738  }
    739  return unsatisfied;
    740 }
    741 
    742 Planner.prototype.addConstraintsConsumingTo = function (v, coll) {
    743  var determining = v.determinedBy;
    744  var cc = v.constraints;
    745  for (var i = 0; i < cc.size(); i++) {
    746    var c = cc.at(i);
    747    if (c != determining && c.isSatisfied())
    748      coll.add(c);
    749  }
    750 }
    751 
    752 /* --- *
    753 * P l a n
    754 * --- */
    755 
    756 /**
    757 * A Plan is an ordered list of constraints to be executed in sequence
    758 * to resatisfy all currently satisfiable constraints in the face of
    759 * one or more changing inputs.
    760 */
    761 function Plan() {
    762  this.v = new OrderedCollection();
    763 }
    764 
    765 Plan.prototype.addConstraint = function (c) {
    766  this.v.add(c);
    767 }
    768 
    769 Plan.prototype.size = function () {
    770  return this.v.size();
    771 }
    772 
    773 Plan.prototype.constraintAt = function (index) {
    774  return this.v.at(index);
    775 }
    776 
    777 Plan.prototype.execute = function () {
    778  for (var i = 0; i < this.size(); i++) {
    779    var c = this.constraintAt(i);
    780    c.execute();
    781  }
    782 }
    783 
    784 /* --- *
    785 * M a i n
    786 * --- */
    787 
    788 /**
    789 * This is the standard DeltaBlue benchmark. A long chain of equality
    790 * constraints is constructed with a stay constraint on one end. An
    791 * edit constraint is then added to the opposite end and the time is
    792 * measured for adding and removing this constraint, and extracting
    793 * and executing a constraint satisfaction plan. There are two cases.
    794 * In case 1, the added constraint is stronger than the stay
    795 * constraint and values must propagate down the entire length of the
    796 * chain. In case 2, the added constraint is weaker than the stay
    797 * constraint so it cannot be accomodated. The cost in this case is,
    798 * of course, very low. Typical situations lie somewhere between these
    799 * two extremes.
    800 */
    801 function chainTest(n) {
    802  planner = new Planner();
    803  var prev = null, first = null, last = null;
    804 
    805  // Build chain of n equality constraints
    806  for (var i = 0; i <= n; i++) {
    807    var name = "v" + i;
    808    var v = new Variable(name);
    809    if (prev != null)
    810      new EqualityConstraint(prev, v, Strength.REQUIRED);
    811    if (i == 0) first = v;
    812    if (i == n) last = v;
    813    prev = v;
    814  }
    815 
    816  new StayConstraint(last, Strength.STRONG_DEFAULT);
    817  var edit = new EditConstraint(first, Strength.PREFERRED);
    818  var edits = new OrderedCollection();
    819  edits.add(edit);
    820  var plan = planner.extractPlanFromConstraints(edits);
    821  for (var i = 0; i < 100; i++) {
    822    first.value = i;
    823    plan.execute();
    824    assertEq(last.value, i);
    825  }
    826 }
    827 
    828 /**
    829 * This test constructs a two sets of variables related to each
    830 * other by a simple linear transformation (scale and offset). The
    831 * time is measured to change a variable on either side of the
    832 * mapping and to change the scale and offset factors.
    833 */
    834 function projectionTest(n) {
    835  planner = new Planner();
    836  var scale = new Variable("scale", 10);
    837  var offset = new Variable("offset", 1000);
    838  var src = null, dst = null;
    839 
    840  var dests = new OrderedCollection();
    841  for (var i = 0; i < n; i++) {
    842    src = new Variable("src" + i, i);
    843    dst = new Variable("dst" + i, i);
    844    dests.add(dst);
    845    new StayConstraint(src, Strength.NORMAL);
    846    new ScaleConstraint(src, scale, offset, dst, Strength.REQUIRED);
    847  }
    848 
    849  change(src, 17);
    850  assertEq(dst.value, 1170);
    851  change(dst, 1050);
    852  assertEq(src.value, 5);
    853  change(scale, 5);
    854  for (var i = 0; i < n - 1; i++) {
    855    assertEq(dests.at(i).value, i * 5 + 1000);
    856  }
    857  change(offset, 2000);
    858  for (var i = 0; i < n - 1; i++) {
    859    assertEq(dests.at(i).value, i * 5 + 2000);
    860  }
    861 }
    862 
    863 function change(v, newValue) {
    864  var edit = new EditConstraint(v, Strength.PREFERRED);
    865  var edits = new OrderedCollection();
    866  edits.add(edit);
    867  var plan = planner.extractPlanFromConstraints(edits);
    868  for (var i = 0; i < 10; i++) {
    869    v.value = newValue;
    870    plan.execute();
    871  }
    872  edit.destroyConstraint();
    873 }
    874 
    875 // Global variable holding the current planner.
    876 var planner = null;
    877 
    878 function deltaBlue() {
    879  chainTest(100);
    880  projectionTest(100);
    881 }
    882 
    883 deltaBlue();