Skip to content

Commit 65bf013

Browse files
committed
Run apidocs after all the comment changes.
1 parent e97f821 commit 65bf013

File tree

4 files changed

+20
-108
lines changed

4 files changed

+20
-108
lines changed

docs/api_data.js

Lines changed: 9 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,7 @@ define({ "api": [
139139
"url": "Hooks",
140140
"title": "Hooks",
141141
"name": "Hooks",
142-
"description": "<p>Here are the standard hooks that fire (in order) on the bootstrap of your Reactium application.</p> <table> <thead> <tr> <th style=\"text-align:left\">Hook</th> <th style=\"text-align:left\">Description</th> </tr> </thead> <tbody> <tr> <td style=\"text-align:left\">init</td> <td style=\"text-align:left\">Called before all other hooks on startup.</td> </tr> <tr> <td style=\"text-align:left\">dependencies-load</td> <td style=\"text-align:left\">Called while application dependencies are loaded.</td> </tr> <tr> <td style=\"text-align:left\">service-worker-init</td> <td style=\"text-align:left\">Called while service worker is loaded.</td> </tr> <tr> <td style=\"text-align:left\">zone-defaults</td> <td style=\"text-align:left\">Called while rendering zone default components are loaded.</td> </tr> <tr> <td style=\"text-align:left\">store-create</td> <td style=\"text-align:left\">Called while Redux store is being created.</td> </tr> <tr> <td style=\"text-align:left\">store-created</td> <td style=\"text-align:left\">Called after Redux store is created.</td> </tr> <tr> <td style=\"text-align:left\">plugin-dependencies</td> <td style=\"text-align:left\">Called before loading runtime plugins.</td> </tr> <tr> <td style=\"text-align:left\">plugin-init</td> <td style=\"text-align:left\">Called to initiate plugin registration.</td> </tr> <tr> <td style=\"text-align:left\">routes-init</td> <td style=\"text-align:left\">Called to initiaze React router</td> </tr> <tr> <td style=\"text-align:left\">register-route</td> <td style=\"text-align:left\">Called for each route that is registered</td> </tr> <tr> <td style=\"text-align:left\">data-loaded</td> <td style=\"text-align:left\">Called on route load to pre-load data</td> </tr> <tr> <td style=\"text-align:left\">plugin-ready</td> <td style=\"text-align:left\">Called after all plugins registration callbacks have completed</td> </tr> <tr> <td style=\"text-align:left\">component-bindings</td> <td style=\"text-align:left\">Called to sibling React components and their DOM element bindings</td> </tr> <tr> <td style=\"text-align:left\">app-bindpoint</td> <td style=\"text-align:left\">Called to define the main application bind point.</td> </tr> <tr> <td style=\"text-align:left\">app-context-provider</td> <td style=\"text-align:left\">Called to define React application-wrapping context providers, such as Redux / Theme, etc.</td> </tr> <tr> <td style=\"text-align:left\">app-router</td> <td style=\"text-align:left\">Called to provide the React router component</td> </tr> <tr> <td style=\"text-align:left\">app-ssr-mode</td> <td style=\"text-align:left\">Called to make the application aware of server-side rendering mode</td> </tr> <tr> <td style=\"text-align:left\">app-boot-message</td> <td style=\"text-align:left\">Called to define the javascript console boot message</td> </tr> <tr> <td style=\"text-align:left\">app-ready</td> <td style=\"text-align:left\">Called when the application is being bound or hydrated by ReactDOM</td> </tr> </tbody> </table>",
142+
"description": "<p>Here are the standard hooks that fire (in order) on the bootstrap of your Reactium application.</p> <table> <thead> <tr> <th style=\"text-align:left\">Hook</th> <th style=\"text-align:left\">Description</th> </tr> </thead> <tbody> <tr> <td style=\"text-align:left\">init</td> <td style=\"text-align:left\">Called before all other hooks on startup.</td> </tr> <tr> <td style=\"text-align:left\">dependencies-load</td> <td style=\"text-align:left\">Called while application dependencies are loaded.</td> </tr> <tr> <td style=\"text-align:left\">service-worker-init</td> <td style=\"text-align:left\">Called while service worker is loaded.</td> </tr> <tr> <td style=\"text-align:left\">zone-defaults</td> <td style=\"text-align:left\">Called while rendering zone default components are loaded.</td> </tr> <tr> <td style=\"text-align:left\">store-create</td> <td style=\"text-align:left\">Called while Redux store is being created.</td> </tr> <tr> <td style=\"text-align:left\">store-created</td> <td style=\"text-align:left\">Called after Redux store is created.</td> </tr> <tr> <td style=\"text-align:left\">plugin-dependencies</td> <td style=\"text-align:left\">Called before loading runtime plugins.</td> </tr> <tr> <td style=\"text-align:left\">plugin-init</td> <td style=\"text-align:left\">Called to initiate plugin registration.</td> </tr> <tr> <td style=\"text-align:left\">routes-init</td> <td style=\"text-align:left\">Called to initiaze React router</td> </tr> <tr> <td style=\"text-align:left\">register-route</td> <td style=\"text-align:left\">Called for each route that is registered</td> </tr> <tr> <td style=\"text-align:left\">data-loaded</td> <td style=\"text-align:left\">Called on route load to pre-load data</td> </tr> <tr> <td style=\"text-align:left\">plugin-ready</td> <td style=\"text-align:left\">Called after all plugins registration callbacks have completed</td> </tr> <tr> <td style=\"text-align:left\">component-bindings</td> <td style=\"text-align:left\">Called to sibling React components and their DOM element bindings</td> </tr> <tr> <td style=\"text-align:left\">app-bindpoint</td> <td style=\"text-align:left\">Called to define the main application bind point.</td> </tr> <tr> <td style=\"text-align:left\">app-context-provider</td> <td style=\"text-align:left\">Called to define React application-wrapping context providers, such as Redux / Theme, etc.</td> </tr> <tr> <td style=\"text-align:left\">app-router</td> <td style=\"text-align:left\">Called to provide the React router component</td> </tr> <tr> <td style=\"text-align:left\">app-boot-message</td> <td style=\"text-align:left\">Called to define the javascript console boot message</td> </tr> <tr> <td style=\"text-align:left\">app-ready</td> <td style=\"text-align:left\">Called when the application is being bound or hydrated by ReactDOM</td> </tr> </tbody> </table>",
143143
"group": "Hooks",
144144
"version": "0.0.0",
145145
"filename": ".core/app/reactium-hooks.js",
@@ -806,19 +806,6 @@ define({ "api": [
806806
"description": "<p>The final hook run after the front-end application has bee bound or hydrated. After this point, the all hooks are runtime hooks.</p>",
807807
"name": "app-ready",
808808
"group": "Hooks",
809-
"parameter": {
810-
"fields": {
811-
"Parameter": [
812-
{
813-
"group": "Parameter",
814-
"type": "Boolean",
815-
"optional": false,
816-
"field": "ssr",
817-
"description": "<p>If the app is in server-side rendering mode (SSR) <code>true</code> is passed to the hook.</p>"
818-
}
819-
]
820-
}
821-
},
822809
"version": "0.0.0",
823810
"filename": ".core/app/index.js",
824811
"groupTitle": "Hooks"
@@ -879,7 +866,7 @@ define({ "api": [
879866
"url": "dependencies-load",
880867
"title": "dependencies-load",
881868
"name": "dependencies-load",
882-
"description": "<p>Called after init to give an application a change to load async dependencies. Many Domain Driven Design (DDD) artifacts from generated src/manifest.js are loaded on this hook async only - used in front-end or isomorphically when running server-side rendering mode (SSR)</p>",
869+
"description": "<p>Called after init to give an application a change to load async dependencies. Many Domain Driven Design (DDD) artifacts from generated src/manifest.js are loaded on this hook async only - used in front-end</p>",
883870
"group": "Hooks",
884871
"version": "0.0.0",
885872
"filename": ".core/app/index.js",
@@ -890,7 +877,7 @@ define({ "api": [
890877
"url": "dependencies-load",
891878
"title": "dependencies-load",
892879
"name": "dependencies-load",
893-
"description": "<p>Called after init to give an application a change to load async dependencies. Many Domain Driven Design (DDD) artifacts from generated src/manifest.js are loaded on this hook async only - used in front-end or isomorphically when running server-side rendering mode (SSR)</p>",
880+
"description": "<p>Called after init to give an application a change to load async dependencies. Many Domain Driven Design (DDD) artifacts from generated src/manifest.js are loaded on this hook async only - used in front-end</p>",
894881
"group": "Hooks",
895882
"version": "0.0.0",
896883
"filename": ".core/app/reactium-hooks.js",
@@ -901,7 +888,7 @@ define({ "api": [
901888
"url": "init",
902889
"title": "init",
903890
"name": "init",
904-
"description": "<p>Called before all other hooks on Reactium application startup. async only - used in front-end or isomorphically when running server-side rendering mode (SSR)</p>",
891+
"description": "<p>Called before all other hooks on Reactium application startup. async only - used in front-end</p>",
905892
"group": "Hooks",
906893
"version": "0.0.0",
907894
"filename": ".core/app/index.js",
@@ -912,7 +899,7 @@ define({ "api": [
912899
"url": "plugin-dependencies",
913900
"title": "plugin-dependencies",
914901
"name": "plugin-dependencies",
915-
"description": "<p>Called to indicate all bootstrap dependencies should now be loaded, but before application routes have been initialized. There are 2 default registered callback in Reactium core on this hook. 1. (Highest Priority): The generated src/manifest.js dependencies are attached to this hook context (as context.deps). 2. (High Priority): <code>plugin-init</code> hook will be invoked, at which point all Reactium.Plugin registrations will be called.</p> <pre><code> Any hooks that registered after Reactium.Plugin will only be useful if they happen to be invoked during the normal runtime operations of the application. An important exception to this is `routes-init`, which is deferred until after plugins initialize so they may dynamically add routes before Reactium hands off control to the Router. async only - used in front-end or isomorphically when running server-side rendering mode (SSR)</code></pre>",
902+
"description": "<p>Called to indicate all bootstrap dependencies should now be loaded, but before application routes have been initialized. There are 2 default registered callback in Reactium core on this hook. 1. (Highest Priority): The generated src/manifest.js dependencies are attached to this hook context (as context.deps). 2. (High Priority): <code>plugin-init</code> hook will be invoked, at which point all Reactium.Plugin registrations will be called.</p> <pre><code> Any hooks that registered after Reactium.Plugin will only be useful if they happen to be invoked during the normal runtime operations of the application. An important exception to this is `routes-init`, which is deferred until after plugins initialize so they may dynamically add routes before Reactium hands off control to the Router. async only - used in front-end</code></pre>",
916903
"parameter": {
917904
"fields": {
918905
"Parameter": [
@@ -947,7 +934,7 @@ define({ "api": [
947934
"url": "register-route",
948935
"title": "register-route",
949936
"name": "register-route",
950-
"description": "<p>Called on boot after routes-init, and during runtime operation of the front-end application, whenever a new route is registered. Can be used to augment a router object before it is registered to the router. async only - used in front-end or isomorphically when running server-side rendering mode (SSR)</p>",
937+
"description": "<p>Called on boot after routes-init, and during runtime operation of the front-end application, whenever a new route is registered. Can be used to augment a router object before it is registered to the router. async only - used in front-end</p>",
951938
"parameter": {
952939
"fields": {
953940
"Parameter": [
@@ -971,7 +958,7 @@ define({ "api": [
971958
"url": "routes-init",
972959
"title": "routes-init",
973960
"name": "routes-init",
974-
"description": "<p>Called after plugin-init, to add React Router routes to Reactium.Routing register before the Router component is initialized and finally the application is bound to the DOM. async only - used in front-end or isomorphically when running server-side rendering mode (SSR)</p>",
961+
"description": "<p>Called after plugin-init, to add React Router routes to Reactium.Routing register before the Router component is initialized and finally the application is bound to the DOM. async only - used in front-end</p>",
975962
"group": "Hooks",
976963
"version": "0.0.0",
977964
"filename": ".core/sdk/routing/index.js",
@@ -999,43 +986,12 @@ define({ "api": [
999986
"filename": "reactium_modules/@atomic-reactor/reactium-service-worker/sdk/index.js",
1000987
"groupTitle": "Hooks"
1001988
},
1002-
{
1003-
"type": "Hook",
1004-
"url": "store-create",
1005-
"title": "store-create",
1006-
"name": "store-create",
1007-
"description": "<p>Called after dependencies-load to trigger Redux store creator. async only - used in front-end or isomorphically when running server-side rendering mode (SSR)</p>",
1008-
"parameter": {
1009-
"fields": {
1010-
"Parameter": [
1011-
{
1012-
"group": "Parameter",
1013-
"type": "Object",
1014-
"optional": false,
1015-
"field": "params",
1016-
"description": "<p>params.server indicate if is store creation on the server, or in the front-end application</p>"
1017-
},
1018-
{
1019-
"group": "Parameter",
1020-
"type": "Object",
1021-
"optional": false,
1022-
"field": "context",
1023-
"description": "<p>Core implementation of this hook will create the Redux store and set it to context.store.</p>"
1024-
}
1025-
]
1026-
}
1027-
},
1028-
"group": "Hooks",
1029-
"version": "0.0.0",
1030-
"filename": ".core/app/reactium-hooks.js",
1031-
"groupTitle": "Hooks"
1032-
},
1033989
{
1034990
"type": "Hook",
1035991
"url": "zone-defaults",
1036992
"title": "zone-defaults",
1037993
"name": "zone-defaults",
1038-
"description": "<p>Called after dependencies-load by Reactium.Zone.init() for loading default component rendering Zone controls and components. async only - used in front-end or isomorphically when running server-side rendering mode (SSR)</p>",
994+
"description": "<p>Called after dependencies-load by Reactium.Zone.init() for loading default component rendering Zone controls and components. async only - used in front-end</p>",
1039995
"parameter": {
1040996
"fields": {
1041997
"Parameter": [
@@ -3664,7 +3620,7 @@ define({ "api": [
36643620
"type": "Object",
36653621
"optional": false,
36663622
"field": "route",
3667-
"description": "<p>object to be used as properties of React Router <code>&lt;Route /&gt;</code> component, including:</p> <ol> <li>path - the routing pattern</li> <li>exact - true/false if the pattern should be matched exactly</li> <li>component - the React component to render on this route</li> <li>order - (special) the priority of this route in the list of routes (which route will resolve first)</li> <li>load - (special) high-order Redux action function (thunk) to run when this route is resolved (should return a promise)</li> <li>... any other property <code>&lt;Route /&gt;</code> component accepts</li> </ol> <h2>Important Note</h2> <p>Unless called in isomorphic javascript (ie. code executed both in browser and in node.js), these routes will not yield Server-Side-Rendered html in SSR mode. The browser will still render the route correctly (will not break the page), however the server will deliver a 404 status code on cold loads of the page (i.e. hard-refresh of the browser).</p>"
3623+
"description": "<p>object to be used as properties of React Router <code>&lt;Route /&gt;</code> component, including:</p> <ol> <li>path - the routing pattern</li> <li>exact - true/false if the pattern should be matched exactly</li> <li>component - the React component to render on this route</li> <li>order - (special) the priority of this route in the list of routes (which route will resolve first)</li> <li>load - (special) high-order Redux action function (thunk) to run when this route is resolved (should return a promise)</li> <li>... any other property <code>&lt;Route /&gt;</code> component accepts</li> </ol> <h2>Important Note</h2> <p>The browser will still render the route correctly (will not break the page), however the server will deliver a 404 status code on cold loads of the page (i.e. hard-refresh of the browser).</p>"
36683624
}
36693625
]
36703626
}

0 commit comments

Comments
 (0)