Expose new convenience function: navigateTo

This is a much nicer interface for kicking off a client transition.

This closes redfin#114.

packages/react-server-test-pages/entrypoints.js

@@ -33,6 +33,10 @@ module.exports = {
 		entry: "/navigation/data-bundle-cache",
 		description: "Data bundle cache",
 	},
+	NavigateTo: {
+		entry: "/navigation/navigateTo",
+		description: "Navigate using `navigateTo()`",
+	},
 	ErrorLogs: {
 		entry: "/error/logs",
 		description: "Generate errors in the logs",

packages/react-server-test-pages/pages/navigation/navigateTo.js

@@ -0,0 +1,17 @@
+import {navigateTo} from "react-server";
+
+const go = page => navigateTo(
+	`/navigation/navigateTo?cur=${page}`,
+	{reuseDom: true}
+)
+
+const Nav = ({cur}) => <div onClick={() => go(cur+1)}>
+	<div>Current page: {cur}</div>
+	<div>Click for next page</div>
+</div>
+
+export default class NavigateToPage {
+	getElements() {
+		return <Nav cur={+this.getRequest().getQuery().cur||0} />
+	}
+}

packages/react-server/core/common.js

@@ -5,6 +5,7 @@ module.exports = {
 	RootElement: require("./components/RootElement"),
 	Link: require('./components/Link'),
 	History: require('./components/History'),
+	navigateTo: require('./util/navigateTo').default,
 	ClientRequest: require('./ClientRequest'),
 	FramebackController: require('./FramebackController'),
 	components: {

packages/react-server/core/util/navigateTo.js

@@ -0,0 +1,12 @@
+import ClientRequest from "../ClientRequest";
+import History from "../components/History";
+import {getCurrentRequestContext} from "../context/RequestContext";
+
+// This initiates a client transition to `path` with `options`.
+// Just a convenience wrapper.
+export default function navigateTo(path, options) {
+	getCurrentRequestContext().navigate(
+		new ClientRequest(path, options),
+		History.events.PUSHSTATE
+	);
+}