dance method

StringBuffer dance(dynamic dawoApp)

Is class better than function? Better looking/finding in editor? Class prevents polluting nameSpace with variable names. devl:LIB #QUEST howTo and where bring #dawoApp to rumba's scope? Now it is just a methods parameter. devl:LIB Add all other buffers to rumbaBuf. PLAN: Do Dance a separate class

Implementation

StringBuffer dance(var dawoApp) {
  //  devl:LIB  Parameters for screen-output wanted.
  _flowC('-->---->--  rumba-dance', true);
  dev.admN.add('>>ADM:CHECK-IN  rumba-dance  >>');

  ///  devl:LIB  rumbaLoop is executed for now only 1-3 times
  ///  primary rumba Loops, over / outside it is: usher loop
  ///  --  rumba loop
  initRumba();

  //  test #word: ; is clay here?
  //  Clay  clay ??  packDawo?

  //  devl:LIB  Add 2 pcs. of Stream / async / wait / then
  ///  --  rumbaLoop
  _flowC('  -->---->--  rumba-loop', true);
  do {
    /// -----------------------  rumbaB loop code   -------------------
    /// some loopS variables to test visibility, and carry msg.
    /// devl:LIB  add some functionality to rumbaLoop____  messages.
    String connectorMsg = '';
    String rumbaLoopRumbaS = '**  rumbaLoop is rolling  **';
    _flowC('   -->---->--  rumba-loop-usher', true);

    ///  --  usher loop
    do {
      String rumbaLoopUsherS = '**  usherLoop is rolling  **';

      ///  duplicating this to get ListOverArea-message
      ///  duplicating this to get ListOverArea-message
      print('-->>-->>--  :rumba:usher: calling :connector:  -->>-->>--');

      connector.join(name, placardM, ':USHER :LOOP :START', ':R:u:');
      connector.roll();
      print('-->>-->>--  :rumba:usher: calling :connector:  -->>-->>--');

      connector.join(name, placardM, ':NEXT :CONNECT :TO :SCOUT', ':R:u:');
      connector.roll();

      /// ----------------------  usher loop code  ---------------------

      ///  --  dawoApp loop
      do {
        String rumbaLoopDawoAppS = '**  dawoAppLoop is rolling  **';
        //  ---------------------  dawo app loop code ------------------
        _flowC('      -->---->--  rumba-loop-dawoApp', true);

        ///  duplicating this to get ListOverArea-message
        print('-->>-->>--  :rumba:usher: calling :connector:  -->>-->>--');
        connector.join(name, placardM, ':RUMBA :3 :TEST :CON', ':R:u:');
        connector.roll();
        connector.box(':R:.do:');

        ///  devl:LIB  dawoApp returns: Map<String, StringBuffer> 10 maps
        ///  Running base activity of dawo.
        dawoApp.roll();

        ///  --  mission loop
        do {
          String rumbaLoopMissionS = '**  missionLoop is rolling  **';

          //  roll already includes rollMissions
          //  NO!! dawoApp.rollMissions();

          //  Handle rumbaLoop___ messages.
          //  Save rumbaLoop__ messages to buffer.
          rumbaBuf.writeAll([rumbaLoopRumbaS, rumbaLoopUsherS]);
          rumbaBuf.writeAll([rumbaLoopDawoAppS, rumbaLoopMissionS]);

          _flowC('     -->---->--  rumba-loop-mission', true);

          // -- chore:  All chore ops go via: Mission

          missionB = false; //  Emergency exit, while testing.
        } while (missionB);
        _flowC('        --<----<--  rumba-loop-mission: done', true);

        dawoAppB = false; //  force loop to run only once.
      } while (dawoAppB);
      _flowC('      --<----<--  rumba-dawo-app: done', true);

      ///
      dawoApp.box(':rumba:');
      usherB = false; //  force loop to run only once.
    } while (usherB);
    _flowC('    --<----<--  rumba-loop-usher: done', true);
    print('-->>-->>--  :rumba:usher: calling :connector:  -->>-->>--');
    connectorMsg = ':ALL :DO :ANSWER ;FAST => :HOW:MANY #Process :ON ?';

    connector.join(name, placardM, connectorMsg, ':R:done:');
    connector.roll();

    doneRumba(); //  --  Do it only once now.
    rumbaB = false;
  } while (rumbaB);
  _flowC('  --<----<--  rumba: done', true);

  /// --  usher loop
  //  No need, it is in next:  dev.showNotes(':RUMBA:');
  rumbaBuf.write(devBox('By:RUMBA-DANCE:', ['* header *', '* footer *'],
      [dev.admN, dev.devN], 0));
  rumbaBuf.write(devBox('By:RUMBA-DANCE:', ['* header *', '* footer *'],
      [dev.innoN, dev.howToN, dev.secN], 0));
  print('--:R:----  one more funny list test   ------');
  //  devl:LIB  add all boxes to rumbaBuf.
  devBox(':R:D:', ['* header *', '* footer *'],
      [dev.innoN, dev.admN, dev.devN, dev.secN], 0);

  var _ll = out.outBufListsForBox();
  print('\n -:R:--->>-->>-->>  outBuffers    --->>-->>-->>-->>--');
  rumbaBuf.write(devBox(
      ':R:D:', ['* header *', '* footer *'], [_ll[1], _ll[2], _ll[3]], 32));
  print(' ');
  devBox(':R:D:', ['* header *', '* footer *'], [_ll[4], _ll[5], _ll[6]], 0);
  print(' ');
  devBox(':R:D:', ['* header *', '* footer *'], [_ll[7], _ll[8]], 0);

  ///  Header and footer from out-buffers-
  devBox(':R:D:', ['* header *', '* footer *'], [_ll[0], _ll[9]], 0);
  print('--<<--;R:--<<--<<  outBuffers  done --<<--<<--<<--<<-- \n');
  //  fFind(':RUMBA-DANCE:', '->>-', 35);
  //  fFind(':RUMBA-DANCE:', 'build', 30);
  //  :BUG:001: Error: when to:  1.0.0
  if (_pB) flow.fFind(':RUMBA-DANCE:', '-->---->--', 35);

  tl.listShow(dev.doneL, ':R:');
  rumbaBuf.writeln('--<<--<<------------  Rumba.dance  done ----------');

  return rumbaBuf;
}