[added] <Redirect/> component

closes #159

Author: ryanflorence

Redirect.js

@@ -0,0 +1 @@
+module.exports = require('./modules/components/Redirect');

docs/api/README.md

@@ -5,6 +5,7 @@ React Router API
 
 - Components
   - [`Link`](/docs/api/components/Link.md)
+  - [`Redirect`](/docs/api/components/Redirect.md)
   - [`Route`](/docs/api/components/Route.md)
   - [`RouteHandler`](/docs/api/components/RouteHandler.md)
   - [`Routes`](/docs/api/components/Routes.md)

docs/api/components/Redirect.md

@@ -0,0 +1,47 @@
+API: `Redirect` (component)
+===========================
+
+Configures a redirect for a path in your route declarations.
+
+Props
+-----
+
+### `from`
+
+The path you want to redirect from, including dynamic segments.
+
+### `to`
+
+The `name` of the route you want to redirect to.
+
+Example
+-------
+
+```xml
+<!--
+  lets say we want to change from `/profile/123` to `/about/123`
+  and redirect `/get-in-touch` to `/contact`
+-->
+<Routes>
+  <Route handler={App}>
+    <Route name="contact" handler={Contact}/>
+    <Route name="about-user" path="about/:userId" handler={UserProfile}/>
+  </Route>
+  
+  <Redirect from="get-in-touch" to="contact" />
+  <Redirect from="profile/:userId" to="about-user" />
+</Routes>
+```
+
+Note that the `<Redirect/>` can be placed anywhere in the route
+hierarchy, if you'd prefer the redirects to be next to their respective
+routes.
+
+```xml
+<Routes>
+  <Route handler={App}>
+    <Route name="contact" handler={Contact}/>
+    <Redirect from="get-in-touch" to="contact" />
+  </Route>
+</Routes>
+```

examples/dynamic-segments/app.js

@@ -3,6 +3,7 @@ var React = require('react');
 var Router = require('../../index');
 var Route = Router.Route;
 var Routes = Router.Routes;
+var Redirect = Router.Redirect;
 var Link = Router.Link;
 
 var App = React.createClass({
@@ -50,6 +51,7 @@ var routes = (
     <Route handler={App}>
       <Route name="user" path="/user/:userId" handler={User}>
         <Route name="task" path="/user/:userId/tasks/:taskId" handler={Task}/>
+        <Redirect from="/user/:userId/todos/:taskId" to="task"/>
       </Route>
     </Route>
   </Routes>

index.js

@@ -1,6 +1,7 @@
 exports.ActiveState = require('./ActiveState');
 exports.AsyncState = require('./AsyncState');
 exports.Link = require('./Link');
+exports.Redirect = require('./Redirect');
 exports.Route = require('./Route');
 exports.Routes = require('./Routes');
 exports.goBack = require('./goBack');

modules/components/Redirect.js

@@ -0,0 +1,25 @@
+var React = require('react');
+var Route = require('./Route');
+
+function Redirect(props) {
+  return Route({
+    path: props.from,
+    handler: createRedirectClass(props.to)
+  });
+}
+
+function createRedirectClass(to) {
+  return React.createClass({
+    statics: {
+      willTransitionTo: function(transition, params, query) {
+        transition.redirect(to, params, query);
+      }
+    },
+
+    render: function() {
+      return null;
+    }
+  });
+}
+
+module.exports = Redirect;