update docs and export more from idom-client-react

Author: rmorshea

docs/source/_static/custom.js

@@ -1608,6 +1608,21 @@ function Element({ model, key }) {
   }
 }
 
+function elementChildren(modelChildren) {
+  if (!modelChildren) {
+    return [];
+  } else {
+    return modelChildren.map((child) => {
+      switch (typeof child) {
+        case "object":
+          return html`<${Element} key=${child.key} model=${child} />`;
+        case "string":
+          return child;
+      }
+    });
+  }
+}
+
 function StandardElement({ model }) {
   const config = react.useContext(LayoutConfigContext);
   const children = elementChildren(model.children);
@@ -1632,7 +1647,7 @@ function ImportedElement({ model }) {
     if (fallback) {
       importSource.then(() => {
         reactDom.unmountComponentAtNode(mountPoint.current);
-        if ( mountPoint.current.children ) {
+        if (mountPoint.current.children) {
           mountPoint.current.removeChild(mountPoint.current.children[0]);
         }
       });
@@ -1673,21 +1688,6 @@ function ImportedElement({ model }) {
   }
 }
 
-function elementChildren(modelChildren) {
-  if (!modelChildren) {
-    return [];
-  } else {
-    return modelChildren.map((child) => {
-      switch (typeof child) {
-        case "object":
-          return html`<${Element} key=${child.key} model=${child} />`;
-        case "string":
-          return child;
-      }
-    });
-  }
-}
-
 function elementAttributes(model, sendEvent) {
   const attributes = Object.assign({}, model.attributes);
 
@@ -1736,22 +1736,13 @@ function loadFromImportSource(config, importSource) {
         typeof module.unmountElement == "function"
       ) {
         return {
-          createElement: (type, props) =>
-            module.createElement(module[type], props),
+          createElement: (type, props, children) =>
+            module.createElement(module[type], props, children, config),
           renderElement: module.renderElement,
           unmountElement: module.unmountElement,
         };
       } else {
-        return {
-          createElement: (type, props, children) =>
-            react.createElement(
-              module[type],
-              props,
-              ...elementChildren(children)
-            ),
-          renderElement: reactDom.render,
-          unmountElement: reactDom.unmountComponentAtNode,
-        };
+        console.error(`${module} does not expose the required interfaces`);
       }
     });
 }

docs/source/command-line.rst

@@ -24,11 +24,11 @@ simple and one which allows you to do everything you normally would in Python.
 Does IDOM support any React component?
 --------------------------------------
 
-If you :ref:`Dynamically Install Javascript` components, then the answer is no. Only
-components whose props are JSON serializable, or which expect basic callback functions
-similar to those of standard event handlers (e.g. ``onClick``) will operate as expected.
+If you use :ref:`Dynamically Loaded Components`, then the answer is no. Only components
+whose props are JSON serializable, or which expect basic callback functions similar to
+those of standard event handlers (e.g. ``onClick``) will operate as expected.
 
-However, if you import a pre-built :ref:`Custom Javascript Component <Custom Javascript Components>`
+However, if you import a :ref:`Custom Javascript Component <Custom Javascript Components>`
 then, so long as the bundle has be defined appropriately, any component can be made to
 work, even those that don't rely on React.
 
@@ -54,6 +54,8 @@ These restrictions apply because the Javascript from the CDN must be able to run
 natively in the browser and the module must be able to run in isolation from the main
 application.
 
+See :ref:`Distributing Javascript via CDN_` for more info.
+
 
 What props can I pass to Javascript components?
 -----------------------------------------------

docs/source/faq.rst

@@ -17,7 +17,6 @@ IDOM
 
     core-concepts
     javascript-components
-    command-line
     specifications
 
 .. toctree::
@@ -41,6 +40,7 @@ IDOM
 A package for building highly interactive user interfaces in pure Python inspred by
 `ReactJS <https://reactjs.org/>`__.
 
+
 At a Glance
 -----------