// This script file is licensed under a Creative Commons
// Attribution 4.0 International License (cc by 4.0):
// http://creativecommons.org/licenses/by/4.0/
// You may adapt and/or share this script file for any purpose,
// provided you give credit to http://bridgecomposer.com

//  This script rotates the card holdings in all boards in a document.
//  Each board's cards are rotated by a random number of seats (from zero to three).
//  The board number, dealer, and vulnerability are not changed for any board.
//  For non-zero rotation:
//    The double-dummy analysis (if any) will be cleared.
//    If a board has an Auction section, it will not be changed but may no longer make sense.
//    If a board has a Play section, it will become invalid.

//  Revised 2020-04-10

<job>
<script language="JScript" src="BCConst.js" />
<script language="JScript" src="BCDeal.js" />
<script language="JScript">
var bc = WScript.CreateObject('BridgeComposer.Object');
if (WScript.Arguments.length > 0) {
  bc.Open(WScript.Arguments(0));
} else {
  if (!bc.Open()) WScript.Quit();
}

function ValidDealer(str)
{
  str = str.toUpperCase();
  if (str.length < 1)
    return false;
    
  var ch = str.charAt(0);
  var ix = 'NESW'.indexOf(ch);
  return ix >= 0;
}

var cb = bc.Boards.Count;
var nMod = 0;
for (var ix = 0; ix < cb; ++ix) {
  var brd = bc.Boards.Item(ix);
  var strDealer = brd.TagValue('Dealer');
  if (!ValidDealer(strDealer))
    continue;
    
  var tagDeal = brd.TagValue('Deal');
  if (!ValidDealer(tagDeal))
    continue;
    
  var nRot = bc.Random(4);
  if (nRot === 0)
    continue;

  var vDeal = new Deal(tagDeal);
  var vRot = new Deal('N');
  for (var iHand = 0; iHand < NHANDS; ++iHand) {
    var ih = (iHand - nRot) & 3;  // binary "AND 3" gives modulo 4
    vRot.hand[iHand] = vDeal.hand[ih];
  }
  
  //  Set rotated deal
  //  Note: BC will auto-clear the DDA when the Deal tag changes
  
  var strDeal = vRot.format(strDealer);
  brd.TagValue('Deal') = strDeal;
  ++nMod;
}

if (nMod) bc.Save();
</script>
</job>