Source code and test files for toy robot

Author: Vince Wong

.gitignore

@@ -0,0 +1 @@
+node_modules

PROBLEM.md

@@ -0,0 +1,80 @@
+# Toy Robot Simulator
+
+## Description
+
+- The application is a simulation of a toy robot moving on a square tabletop,
+  of dimensions 5 units x 5 units.
+- There are no other obstructions on the table surface.
+- The robot is free to roam around the surface of the table, but must be
+  prevented from falling to destruction. Any movement that would result in the
+  robot falling from the table must be prevented, however further valid
+  movement commands must still be allowed.
+
+Create an application that can read in commands of the following (textual) form:
+
+    PLACE X,Y,F
+    MOVE
+    LEFT
+    RIGHT
+    REPORT
+
+- PLACE will put the toy robot on the table in position X,Y and facing NORTH,
+  SOUTH, EAST or WEST.
+- The origin (0,0) can be considered to be the SOUTH WEST most corner.
+- The first valid command to the robot is a PLACE command, after that, any
+  sequence of commands may be issued, in any order, including another PLACE
+  command. The application should discard all commands in the sequence until
+  a valid PLACE command has been executed.
+- MOVE will move the toy robot one unit forward in the direction it is
+  currently facing.
+- LEFT and RIGHT will rotate the robot 90 degrees in the specified direction
+  without changing the position of the robot.
+- REPORT will announce the X,Y and F of the robot. This can be in any form,
+  but standard output is sufficient.
+
+- A robot that is not on the table can choose the ignore the MOVE, LEFT, RIGHT
+  and REPORT commands.
+- Input can be from a file, or from standard input, as the developer chooses.
+- Provide test data to exercise the application.
+- The application must be a command line application.
+
+## Constraints
+
+- The toy robot must not fall off the table during movement. This also
+  includes the initial placement of the toy robot.
+- Any move that would cause the robot to fall must be ignored.
+
+## Example Input and Output
+
+### Example a
+
+    PLACE 0,0,NORTH
+    MOVE
+    REPORT
+
+Expected output:
+
+    0,1,NORTH
+
+### Example b
+
+    PLACE 0,0,NORTH
+    LEFT
+    REPORT
+
+Expected output:
+
+    0,0,WEST
+
+### Example c
+
+    PLACE 1,2,EAST
+    MOVE
+    MOVE
+    LEFT
+    MOVE
+    REPORT
+
+Expected output
+
+    3,3,NORTH

README.md

@@ -0,0 +1,30 @@
+# NodeJS CLI Toy Robot Simulator
+
+## Description
+
+This is a NodeJS command-line application. The Node version used to develop this is v10.11.0.
+
+## Demo Video Link
+
+## Installation
+
+1. Install globally by running `npm install -g`
+2. Execute the command `toy-robot`
+
+## Running it from source
+
+1. Install dependencies by running `yarn install`
+2. Start the program by running `yarn start`
+
+## Different Cases Handled
+
+- When user go through the normal flow
+- When user keys in an invalid 1st command (that should be a PLACE command)
+- When user keys in an invalid coordinate
+- When user keys in an invalid direction
+- When user keys in an invalid commands (input other than PLACE, MOVE, LEFT, RIGHT, REPORT)
+- When the toy robot had moved to an invalid coordinate (changes will be discarded)
+
+## Test
+
+You may check on the test by running `yarn test`