refactor: renaming sandbox files (#141)

* refactor(sandbox): renamed files to stories

* refactor(sandbox): rephrased descriptions

* refactor: renamed files

* refactor: renaming

* chore: merge

packages/pinball_components/sandbox/lib/main.dart

@@ -6,7 +6,6 @@
 // https://opensource.org/licenses/MIT.
 import 'package:dashbook/dashbook.dart';
 import 'package:flutter/material.dart';
-import 'package:sandbox/stories/spaceship/spaceship.dart';
 import 'package:sandbox/stories/stories.dart';
 
 void main() {

packages/pinball_components/sandbox/lib/stories/ball/ball_booster_game.dart

@@ -3,8 +3,12 @@ import 'package:flutter/material.dart';
 import 'package:pinball_components/pinball_components.dart';
 import 'package:sandbox/common/common.dart';
 
-class BallBoosterExample extends LineGame {
+class BallBoosterGame extends LineGame {
-  static const info = '';
+  static const info = '''
+    Shows how a Ball with a boost works.
+
+    Drag to launch a boosted Ball.
+''';
 
   @override
   void onLine(Vector2 line) {

packages/pinball_components/sandbox/lib/stories/ball/basic_ball_game.dart

@@ -7,9 +7,9 @@ class BasicBallGame extends BasicGame with TapDetector {
   BasicBallGame({required this.color});
 
   static const info = '''
-      Basic example of how a Ball works.
+    Shows how a Ball works.
       
-      Tap anywhere on the screen to spawn a ball into the game.
+    Tap anywhere on the screen to spawn a ball into the game.
 ''';
 
   final Color color;

packages/pinball_components/sandbox/lib/stories/ball/stories.dart

@@ -2,8 +2,8 @@ import 'package:dashbook/dashbook.dart';
 import 'package:flame/game.dart';
 import 'package:flutter/material.dart';
 import 'package:sandbox/common/common.dart';
-import 'package:sandbox/stories/ball/ball_booster.dart';
+import 'package:sandbox/stories/ball/ball_booster_game.dart';
-import 'package:sandbox/stories/ball/basic.dart';
+import 'package:sandbox/stories/ball/basic_ball_game.dart';
 
 void addBallStories(Dashbook dashbook) {
   dashbook.storiesOf('Ball')
@@ -20,9 +20,9 @@ void addBallStories(Dashbook dashbook) {
     ..add(
       'Booster',
       (context) => GameWidget(
-        game: BallBoosterExample(),
+        game: BallBoosterGame(),
       ),
       codeLink: buildSourceLink('ball/ball_booster.dart'),
-      info: BallBoosterExample.info,
+      info: BallBoosterGame.info,
     );
 }

packages/pinball_components/sandbox/lib/stories/baseboard/basic_baseboard_game.dart

@@ -3,9 +3,7 @@ import 'package:pinball_components/pinball_components.dart';
 import 'package:sandbox/common/common.dart';
 
 class BasicBaseboardGame extends BasicGame {
-  static const info = '''
+  static const info = 'Shows how a Baseboard works.';
-      Basic example of how a Baseboard works.
-''';
 
   @override
   Future<void> onLoad() async {

packages/pinball_components/sandbox/lib/stories/baseboard/stories.dart

@@ -1,7 +1,7 @@
 import 'package:dashbook/dashbook.dart';
 import 'package:flame/game.dart';
 import 'package:sandbox/common/common.dart';
-import 'package:sandbox/stories/baseboard/basic.dart';
+import 'package:sandbox/stories/baseboard/basic_baseboard_game.dart';
 
 void addBaseboardStories(Dashbook dashbook) {
   dashbook.storiesOf('Baseboard').add(

packages/pinball_components/sandbox/lib/stories/chrome_dino/chrome_dino_game.dart

@@ -2,9 +2,7 @@ import 'package:flame_forge2d/flame_forge2d.dart';
 import 'package:pinball_components/pinball_components.dart';
 
 class ChromeDinoGame extends Forge2DGame {
-  static const info = '''
+  static const info = 'Shows how a ChromeDino is rendered.';
-  Shows how a ChromeDino is rendered.
-''';
 
   @override
   Future<void> onLoad() async {

packages/pinball_components/sandbox/lib/stories/dash_nest_bumper/big_dash_nest_bumper_game.dart

@@ -3,7 +3,7 @@ import 'dart:ui';
 
 import 'package:pinball_components/pinball_components.dart';
 import 'package:sandbox/common/common.dart';
-import 'package:sandbox/stories/ball/basic.dart';
+import 'package:sandbox/stories/ball/basic_ball_game.dart';
 
 class BigDashNestBumperGame extends BasicBallGame {
   BigDashNestBumperGame({
@@ -11,9 +11,9 @@ class BigDashNestBumperGame extends BasicBallGame {
   }) : super(color: const Color(0xFF0000FF));
 
   static const info = '''
-      Shows how a BigDashNestBumper is rendered.
+    Shows how a BigDashNestBumper is rendered.
 
-      Activate the trace to see the body shape.
+    Activate the "trace" parameter to overlay the body.
 ''';
 
   final bool trace;

packages/pinball_components/sandbox/lib/stories/dash_nest_bumper/stories.dart

@@ -1,8 +1,8 @@
 import 'package:dashbook/dashbook.dart';
 import 'package:flame/game.dart';
 import 'package:sandbox/common/common.dart';
-import 'package:sandbox/stories/ball/basic.dart';
+import 'package:sandbox/stories/ball/basic_ball_game.dart';
-import 'package:sandbox/stories/dash_nest_bumper/big.dart';
+import 'package:sandbox/stories/dash_nest_bumper/big_dash_nest_bumper_game.dart';
 
 void addDashNestBumperStories(Dashbook dashbook) {
   dashbook.storiesOf('Dash Nest Bumpers').add(

packages/pinball_components/sandbox/lib/stories/effects/fire_effect_game.dart

@@ -2,9 +2,12 @@ import 'package:flame/components.dart';
 import 'package:pinball_components/pinball_components.dart';
 import 'package:sandbox/common/common.dart';
 
-class FireEffectExample extends LineGame {
+class FireEffectGame extends LineGame {
-  static const info = 'Demonstrate the fire trail effect '
+  static const info = '''
-      'drag a line to define the trail direction';
+  Shows how the FireEffect renders.
+
+  Drag a line to define the trail direction.
+''';
 
   @override
   void onLine(Vector2 line) {

packages/pinball_components/sandbox/lib/stories/effects/stories.dart

@@ -1,13 +1,13 @@
 import 'package:dashbook/dashbook.dart';
 import 'package:flame/game.dart';
 import 'package:sandbox/common/common.dart';
-import 'package:sandbox/stories/effects/fire_effect.dart';
+import 'package:sandbox/stories/effects/fire_effect_game.dart';
 
 void addEffectsStories(Dashbook dashbook) {
   dashbook.storiesOf('Effects').add(
         'Fire Effect',
-        (context) => GameWidget(game: FireEffectExample()),
+        (context) => GameWidget(game: FireEffectGame()),
         codeLink: buildSourceLink('effects/fire_effect.dart'),
-        info: FireEffectExample.info,
+        info: FireEffectGame.info,
       );
 }

packages/pinball_components/sandbox/lib/stories/flipper/basic_flipper_game.dart

@@ -3,14 +3,12 @@ import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
 import 'package:pinball_components/pinball_components.dart';
 
-import 'package:sandbox/stories/ball/basic.dart';
+import 'package:sandbox/stories/ball/basic_ball_game.dart';
 
 class BasicFlipperGame extends BasicBallGame with KeyboardEvents {
   BasicFlipperGame() : super(color: Colors.blue);
 
-  static const info = '''
+  static const info = 'Shows how a Flipper works.';
-      Basic example of how a Flipper works.
-''';
 
   static const _leftFlipperKeys = [
     LogicalKeyboardKey.arrowLeft,

packages/pinball_components/sandbox/lib/stories/flipper/flipper_tracing_game.dart

@@ -2,11 +2,11 @@ import 'dart:async';
 
 import 'package:flame_forge2d/flame_forge2d.dart';
 import 'package:sandbox/common/common.dart';
-import 'package:sandbox/stories/flipper/basic.dart';
+import 'package:sandbox/stories/flipper/basic_flipper_game.dart';
 
 class FlipperTracingGame extends BasicFlipperGame {
   static const info = '''
-      Basic example of how the Flipper body overlays the sprite.
+    Basic example of how the Flipper body overlays the sprite.
 ''';
 
   @override

packages/pinball_components/sandbox/lib/stories/flipper/stories.dart

@@ -1,8 +1,8 @@
 import 'package:dashbook/dashbook.dart';
 import 'package:flame/game.dart';
 import 'package:sandbox/common/common.dart';
-import 'package:sandbox/stories/flipper/basic.dart';
+import 'package:sandbox/stories/flipper/basic_flipper_game.dart';
-import 'package:sandbox/stories/flipper/tracing.dart';
+import 'package:sandbox/stories/flipper/flipper_tracing_game.dart';
 
 void addFlipperStories(Dashbook dashbook) {
   dashbook.storiesOf('Flipper')

packages/pinball_components/sandbox/lib/stories/layer/basic_layer_game.dart

@@ -8,9 +8,9 @@ class BasicLayerGame extends BasicGame with TapDetector {
   BasicLayerGame({required this.color});
 
   static const info = '''
-      Basic example of how layers work when a Ball hits other components.
+    Shows how Layers work when a Ball hits other components.
       
-      Tap anywhere on the screen to spawn a ball into the game.
+    Tap anywhere on the screen to spawn a Ball into the game.
 ''';
 
   final Color color;

packages/pinball_components/sandbox/lib/stories/layer/stories.dart

@@ -2,7 +2,7 @@ import 'package:dashbook/dashbook.dart';
 import 'package:flame/game.dart';
 import 'package:flutter/material.dart';
 import 'package:sandbox/common/common.dart';
-import 'package:sandbox/stories/layer/basic.dart';
+import 'package:sandbox/stories/layer/basic_layer_game.dart';
 
 void addLayerStories(Dashbook dashbook) {
   dashbook.storiesOf('Layer').add(

packages/pinball_components/sandbox/lib/stories/spaceship/basic_spaceship_game.dart

@@ -5,9 +5,12 @@ import 'package:flutter/material.dart';
 import 'package:pinball_components/pinball_components.dart';
 import 'package:sandbox/common/common.dart';
 
-class BasicSpaceship extends BasicGame with TapDetector {
+class BasicSpaceshipGame extends BasicGame with TapDetector {
-  static String info = 'Renders a spaceship and allows balls to be '
+  static const info = '''
-      'spawned upon click to test their interactions';
+    Shows how a Spaceship works.
+      
+    Tap anywhere on the screen to spawn a Ball into the game.
+''';
 
   @override
   Future<void> onLoad() async {

packages/pinball_components/sandbox/lib/stories/spaceship/stories.dart

@@ -1,13 +1,15 @@
 import 'package:dashbook/dashbook.dart';
 import 'package:flame/game.dart';
 import 'package:sandbox/common/common.dart';
-import 'package:sandbox/stories/spaceship/basic.dart';
+import 'package:sandbox/stories/spaceship/basic_spaceship_game.dart';
 
 void addSpaceshipStories(Dashbook dashbook) {
   dashbook.storiesOf('Spaceship').add(
         'Basic',
-        (context) => GameWidget(game: BasicSpaceship()),
+        (context) => GameWidget(
+          game: BasicSpaceshipGame(),
+        ),
         codeLink: buildSourceLink('spaceship/basic.dart'),
-        info: BasicSpaceship.info,
+        info: BasicSpaceshipGame.info,
       );
 }

packages/pinball_components/sandbox/lib/stories/stories.dart

@@ -1,7 +1,8 @@
-export 'ball/ball.dart';
+export 'ball/stories.dart';
-export 'baseboard/baseboard.dart';
+export 'baseboard/stories.dart';
 export 'chrome_dino/stories.dart';
-export 'dash_nest_bumper/dash_nest_bumper.dart';
+export 'dash_nest_bumper/stories.dart';
-export 'effects/effects.dart';
+export 'effects/stories.dart';
-export 'flipper/flipper.dart';
+export 'flipper/stories.dart';
-export 'layer/layer.dart';
+export 'layer/stories.dart';
+export 'spaceship/stories.dart';