document dom ready optimization

Author: theKashey

README.md

@@ -1,5 +1,6 @@
 <div align="center">
   <h1>IMPORTED COMPONENT ✂</h1>
+  <h2>Code splitting which always works<sup>*</sup></h2>
   <br/>
   <img src="./assets/imported-logo.png" alt="imported components" width="409" align="center">
   <br/>
@@ -31,17 +32,20 @@
   <br/>
 </div>
 
+> <sup>*</sup> It's really will never let you down. All credits to your bundler. 
+
 👉 [Usage](#usage)  |  [API](#api) | [Setup](#setup) | [SSR](#ssr)  | [CCS](#css) [Concurrent loading](#concurrent-loading)  |  [Webpack/Parcel](#bundler-integration) 
 
 
 Key features:
- - 1️⃣ Single source of truth - your __bundler drives__ everything.
+ - 1️⃣ Single source of truth - your __bundler drives__ everything
  - 📖 __library__ level code __splitting__
  - 🧙️ Hybrid and __Prerendering__ compatible
  - 💡 __TypeScript__ bindings
  - ⚛️ __React.Lazy__ underneath (if hot module updates are disabled)
  - 🌟 Async on client, sync on server. Supports __Suspense__ (even on server side)
- - 📦 could work with __any bundler__ - webpack, rollup, parcel or puppeteer - it does not matter 
+ - 📦 could work with __any bundler__ - webpack, rollup, parcel or puppeteer - it does not matter
+ - 🤹‍♂️ working as well with any `import` you may provide
 
  Other features:
  - 🔥 Hot-Module-Replacement/React-Hot-Loader friendly
@@ -53,24 +57,24 @@ Key features:
  - 📦 and yes - this is the only __parcel-bundler compatible__ SSR-friendly React code splitting library
 
  👍 Better than [React.Lazy](https://reactjs.org/docs/code-splitting.html#reactlazy):
- - It __IS__ Lazy, just with some stuff around*
- - SSR, Prerendering and Preloading support.
- - With or without Suspense, and easier Error cases support.
+ - It __IS__ Lazy, just with some stuff around<sup>*</sup>
+ - SSR, Prerendering and Preloading support
+ - With or without Suspense, and easier Error cases support
 
  👍 Better than others:
- - Not bound to webpack.
- - Easy way to use per-browser(modern/legacy) bundles.
- - Strong typing.
- - Prerendering support
+ - Not bound to webpack
+ - Easy way to use per-browser(modern/legacy) bundles - you down have to mess with actual browser support
+ - Strong typing
+ - Working with any imports, even native, external or derived ones. 
 
  👌 Client-side module resolution
  - Loads chunks only after the `main one`, as long as loader code is bundled inside the main chunk, so it should be loaded first.
  - Not an issue with the `progressive hydration`, and might provide a better UX via feature detection.
  - Provides 👨‍🔬 technological workaround - [see here](#concurrent-loading)
 
  📦 Optional bundler integration for the best experience
- - prefetching backed by webpack stat.json and asset.json
- - parcel-manifest support
+ - prefetching backed by webpack `stat.json` and `asset.json`
+ - `parcel-manifest.json` support
 
  👯‍♀️Works better in pair
  - [react-prerendered-component](https://github.com/theKashey/react-prerendered-component) for prerendering, partial hydration and react fragment caching
@@ -356,6 +360,27 @@ And let's call it - a __Scheduler optimization__. See __loading prediction__ sec
 ```
 This will just start loading extra chunks before the main bundle got completely parsed and executed.
 
+#### Defer till DOMReady
+> 💡 Another perfect option would be to wait till DomReady event.
+
+```js
+ // index.js (boot)
+ import './src/imported'; // the file generated by "generate-imported-component" (.2)
+ import {rehydrateMarks} from 'react-imported-component/boot';
+  
+ rehydrateMarks(); // just start loading what's needed
+ 
+
+ const startApp =  () => require('./main'); // <--- your main scripts
+ 
+ // it's "not safe" to start you application before DOM is "ready"
+ if (document.readyState === "loading") {
+   document.addEventListener("DOMContentLoaded", startApp);
+ } else {
+   startApp();
+ };  
+```
+
 #### Scheduler optimization + stream render
 > See examples/SSR/parcel-react-ssr/server-stream for details
 1. Add your main bundle to the `head`, using __async__ script tag. Not defer! We have to do it async