expose reactOnRailsPageLoaded to ReactOnRails

docs/additional-reading/turbolinks.md

@@ -28,6 +28,24 @@ Turbolinks 5 is now being supported. React on Rails will automatically detect wh
 
 For more information on Turbolinks 5: [https://github.com/turbolinks/turbolinks](https://github.com/turbolinks/turbolinks)
 
+### async script loading
+Generally async script loading can be done like:
+```erb
+  <%= javascript_include_tag 'application', async: Rails.env.production? %>
+```
+If you use ```document.addEventListener("turbolinks:load", function() {...});``` somewhere in your code, you will notice, that Turbolinks 5 does not fire ```turbolinks:load``` on initial page load. A quick workaround is to use ```defer``` instead of ```async```:
+```erb
+  <%= javascript_include_tag 'application', defer: Rails.env.production? %>
+```
+More information on this issue can be found here: https://github.com/turbolinks/turbolinks/issues/28
+
+When loading your scripts asynchronously you may experience, that your Components are not registered correctly. Call ```ReactOnRails.reactOnRailsPageLoaded()``` to re-initialize like so:
+```
+  document.addEventListener("turbolinks:load", function() {
+    ReactOnRails.reactOnRailsPageLoaded();
+  });
+```
+
 ## Troubleshooting
 To turn on tracing of Turbolinks events, put this in your registration file, where you register your components.
 

node_package/src/ReactOnRails.js

@@ -1,4 +1,4 @@
-import clientStartup from './clientStartup';
+import * as ClientStartup from './clientStartup';
 import handleError from './handleError';
 import ComponentRegistry from './ComponentRegistry';
 import StoreRegistry from './StoreRegistry';
@@ -63,6 +63,10 @@ ctx.ReactOnRails = {
     }
   },
 
+  reactOnRailsPageLoaded() {
+    ClientStartup.reactOnRailsPageLoaded();
+  },
+
   ////////////////////////////////////////////////////////////////////////////////
   // INTERNALLY USED APIs
   ////////////////////////////////////////////////////////////////////////////////
@@ -175,6 +179,6 @@ ctx.ReactOnRails = {
 
 ReactOnRails.resetOptions();
 
-clientStartup(ctx);
+ClientStartup.clientStartup(ctx);
 
 export default ctx.ReactOnRails;

node_package/src/clientStartup.js

@@ -85,7 +85,7 @@ You should return a React.Component always for the client side entry point.`);
   }
 }
 
-function reactOnRailsPageLoaded() {
+export function reactOnRailsPageLoaded() {
   debugTurbolinks('reactOnRailsPageLoaded');
 
   forEachStore(initializeStore);
@@ -103,7 +103,7 @@ function reactOnRailsPageUnloaded() {
   forEachComponent(unmount);
 }
 
-export default function clientStartup(context) {
+export function clientStartup(context) {
   const document = context.document;
 
   // Check if server rendering