Re Architecture SceneSequence

[crexista]

Abstruct

1. Scene, Scenario, Sequence are redesigned, and refactored
2. Some new feature added.

Refactor

A. redefine deference screen and scene
Screen was just Scene's type erasure protocol
And, Screen had sendTransitionRequest and leaveFromCurrent.

but I redefine Screen and Scene as below.

• Screen

  1. Just Display, like a plate.
  2. Screen has two status
  • activated
  • suspended

• Scene

  1. Scene is transitionable screen.
  2. So, Scene has context and returnValue(when rewind)

So, Screen does not have sendTransitionRequest and leaveFromCurrent from now.
And, Scene has sendTransitionRequest and leaveFromCurrent insted of Screen.

B. SceneSequence separate to SceneCollection, ScreenContainer

SceneSequence become complex, so redesigned SceneSequence
So, SceneSequence become to extend SceneCollection and implement ScreenContainer

SceneCollection's job is stacking Scene and activate Scene
detail will be write later..

New Feature

• Scene can define associeated Type ReturnValue
  ReturnValue is type of argument to previous scene when rewind to back scene.

  can use like this

  // on Fist Scene
  sendTransitionRequest(SampleRequest(value){ (result: String) in
    print(result)
  })
  
  // on Second Scene
  leaveFromCurrent(returnValue: String) // SampleRequest's ResultValue Type

• SceneSequence can suspend.
  SceneSequence become to be able to suspend.
  suspended screen cannot sendTransitionRequest(if request is send, it will be ignored)

• SceneSequenceBuilder added.
  SceneSequence's initial parameter is many.
  So SceneSequenceBuilder is maked.

  let builder = SceneSequence.builder(scene: scene, guide: rule)
                             .setup(UINavigationController(rootViewController: UIViewController()), with: false)
  sequence = builder.build(onInvoke: { (stage, scene) in
      stage.isNavigationBarHidden = true
      stage.pushViewController(scene, animated: true)
  }, onActive: { (stage, screens) in
      self.window?.rootViewController?.addChildViewController(stage)
      self.window?.rootViewController?.view.addSubview(stage.view)
  }, onSuspend: { (stage, screens) in
      stage.view.removeFromSuperview()
      stage.removeFromParentViewController()
  })
  
  sequence?.activate()

Breaking Change

• SceneOperation's I/F is changed.

  old

  operation.at(Sample1BViewController.self) { (scenario) in
     scenario.given(SampleARequest.self, { Sample1AViewController() }) { (args) in
         args.stage.pushViewController(args.next, animated: true)
            return {
               args.stage.popViewController(animated: true)
            }
         }
     }
  }

  new

  operation.at(Sample1BViewController.self) { (scenario) in
      scenario.given(SampleARequest.self, transitTo: { Sample1AViewController() }) { (args) in
          args.stage.pushViewController(args.next, animated: true)
             return {
                args.stage.popViewController(animated: true)
             }
          }
      }
  }

[crexista]

this pull request to master.
that's mistake.
so close