Update ReactDOM and add SSR API

.editorconfig

@@ -6,7 +6,7 @@ insert_final_newline = true
 indent_style = tab
 indent_size = 4
 
-[*.json]
+[*.{json,yml}]
 indent_style = space
 indent_size = 2
 

.github/workflows/test.yml

@@ -0,0 +1,48 @@
+name: Tests
+
+on: [push, repository_dispatch]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        haxe: [4.3.2, latest]
+
+    steps:
+    - uses: actions/checkout@v1
+
+    - name: Setup haxe ${{ matrix.haxe }}
+      uses: krdlab/setup-haxe@v1
+      with:
+        haxe-version: ${{ matrix.haxe }}
+
+    - name: Install libs
+      run: |
+        git config --global url."https://github.com/".insteadOf "[email protected]:"
+        haxelib newrepo
+        haxelib install munit
+        haxelib install hxnodejs
+        haxelib git tink_hxx [email protected]:kLabz/tink_hxx.git
+        haxelib git tink_anon [email protected]:haxetink/tink_anon.git
+
+    - name: Run tests
+      run: |
+        haxelib run munit test -js
+
+    - name: "[Samples] SSR sample : react-next docs website"
+      run: |
+        cd samples/docs
+        make setup
+        make server
+        make static
+
+    - name: "[Samples] TODO App"
+      run: |
+        cd samples/todoapp
+        haxelib newrepo
+        haxelib dev react-next ../..
+        haxelib install --skip-dependencies --always install.hxml
+        haxe build.hxml

doc/compilation-flags.md

@@ -1,10 +1,14 @@
+---
+title: Custom compilation flags
+---
+
 # Custom compilation flags used by haxe-react
 
 ## `-debug` / `-D debug`
 
 This is not a custom compilation flag, but it enables/disables some features in
 haxe-react. Basically, you'll want to compile with it when using dev version of
-react, and remove it when using prog version.
+react, and remove it when using prod version.
 
 ### Disabled features
 

doc/custom-meta.md

@@ -1,3 +1,7 @@
+---
+title: Custom metadata
+---
+
 # Custom meta used by haxe-react
 
 ## `@:wrap(hoc)`

doc/defines.json

@@ -0,0 +1,18 @@
+[
+  {
+    "define": "react_no_inline",
+    "doc": "Skip React.createElement inlining optimization."
+  },
+  {
+    "define": "react_global",
+    "doc": "Use window.React instead of require() from modular/webpack."
+  },
+  {
+    "define": "react_hot",
+    "doc": "Adds some data needed for react hot reloading with modular/webpack."
+  },
+  {
+    "define": "react_runtime_warnings",
+    "doc": "Enable some runtime warnings for debug purpose."
+  }
+]

doc/metadata.json

@@ -0,0 +1,19 @@
+[
+  {
+    "metadata": ":wrap",
+    "doc": "Wrap current class component in a HOC.",
+    "params": ["HOC"],
+    "targets": ["TClass"]
+  },
+  {
+    "metadata": ":publicProps",
+    "doc": "Set public props type to ensure jsx type checking.",
+    "params": ["TProps"],
+    "targets": ["TClass"]
+  },
+  {
+    "metadata": ":noPublicProps",
+    "doc": "Disallow public props for this component when used in jsx.",
+    "targets": ["TClass"]
+  }
+]

doc/react-next-roadmap.md

@@ -1,3 +1,8 @@
+---
+order: 1
+title: React "next" Roadmap
+---
+
 # Haxe React #next: roadmap
 
 There's still work to be done being this fork is ready for a haxe-react 2.0.0

doc/react-next.md

@@ -1,3 +1,8 @@
+---
+order: 0
+title: React "next"
+---
+
 # Haxe React #next
 
 Branch `#next` of my haxe-react fork aims to move haxe-react forward to `2.0.0+`
@@ -311,7 +316,7 @@ compatible with other versions.
 * `React._internals.ReactDebugCurrentFrame.getCurrentStack()` will list all
 parent nodes of current element, up to the root node of the application
 
-#### [`TODO`]() Generate PropTypes for more runtime checks on props
+#### [`TODO`](<>) Generate PropTypes for more runtime checks on props
 
 There are already many checks at compile time to ensure you are not doing
 obvious mistakes. However, sometimes the compiler cannot see what is really

doc/react-refs-api.md

@@ -1,3 +1,7 @@
+---
+title: React Refs API (React 16.3)
+---
+
 # New React Refs API (React 16.3)
 
 Externs have been added for [`React.createRef()`][createRef] and

doc/typing-props.md

@@ -1,3 +1,7 @@
+---
+title: Typing your props
+---
+
 # Typing your props with haxe-react
 
 One of the points of using Haxe to develop javascript applications is to benefit

doc/wrapping-with-hoc.md

@@ -1,3 +1,7 @@
+---
+title: Wrap with HOC
+---
+
 # Wrapping your components in HOCs
 
 You can use HOCs with your components (unless they are `@:jsxStatic` components)

haxelib.json

@@ -10,6 +10,11 @@
   "version": "1.122.0",
   "url": "https://github.com/kLabz/haxe-react",
   "classPath": "src/lib",
+  "documentation": {
+    "url": "https://github.com/kLabz/haxe-react/tree/next/doc",
+    "metadata": "doc/metadata.json",
+    "defines": "doc/defines.json"
+  },
   "dependencies": {
     "tink_hxx": "",
     "js-object": ""

samples/docs/.gitignore

@@ -0,0 +1,4 @@
+bin
+.haxelib
+node_modules
+package-lock.json

samples/docs/README.md

@@ -0,0 +1,11 @@
+# Example project: Server side rendering (no hydration)
+
+TODO: add some documentation here, or in `docs` and link here.
+
+Run `make setup` to install dependencies.
+
+Run `make server` to build and then `make start-server` to start the server on
+port `8042`.
+
+To generate static html pages instead, run `make static`, and then
+`make serve-static` to start a http server serving html files on port `8043`.

samples/docs/build-static.hxml

@@ -0,0 +1,6 @@
+#!/usr/bin/env haxe
+
+common.hxml
+
+-main StaticGenerator
+-js bin/static-gen.js

samples/docs/build.hxml

@@ -0,0 +1,6 @@
+#!/usr/bin/env haxe
+
+common.hxml
+
+-main Main
+-js bin/server.js

samples/docs/common.hxml

@@ -0,0 +1,30 @@
+-L react-next
+-L react-css
+-L css-types
+-L classnames
+-L datetime
+-L markdown
+-L event-types
+-L html-entities
+-L tink_domspec
+-L hxnodejs
+-L yaml
+
+-cp src
+
+# -dce full
+-D js-es=6
+# -D analyzer-optimize
+-D message.reporting=pretty
+
+-w -WDeprecatedEnumAbstract
+
+# Configure react-css
+-D react.css.out=bin/styles.css
+-D react.css.base=res/base.css
+# -D react.css.sourcemap=styles.css.map
+
+# Configure react-next
+-D react-wrap-strict
+-D react-check-jsxstatic-type
+-D react-disable-dynamic-components

samples/docs/install.hxml

@@ -0,0 +1,20 @@
+-lib HtmlParser:3.3.2
+-lib js-object:0.0.7
+-lib datetime:3.1.4
+-lib html-entities:1.0.0
+
+-lib tink_macro:1.0.1
+-lib tink_parse:0.4.1
+-lib tink_core:2.1.0
+-lib tink_domspec:0.5.0
+-lib tink_svgspec:0.0.1
+-lib tink_anon:git:[email protected]:haxetink/tink_anon.git#0277e6e
+-lib tink_hxx:git:[email protected]:kLabz/tink_hxx.git#5a01af1
+
+-lib hxnodejs:git:[email protected]:HaxeFoundation/hxnodejs.git#d2d871c
+-lib css-types:git:[email protected]:kLabz/haxe-css-types.git#5f5d2c6
+-lib event-types:git:[email protected]:kLabz/event-types.git#df271a9
+-lib react-css:git:[email protected]:kLabz/haxe-react-css.git#5595611
+-lib classnames:git:[email protected]:kLabz/haxe-classnames.git#30e7436
+-lib yaml:git:[email protected]:kLabz/hx-yaml.git#c61ca1f
+-lib markdown:git:[email protected]:kLabz/haxe-markdown.git#8503130

samples/docs/makefile

@@ -0,0 +1,20 @@
+.SILENT:
+
+setup:
+	haxelib newrepo
+	haxelib dev react-next ../..
+	haxelib install --skip-dependencies --always install.hxml
+	npm i
+
+server:
+	haxe build.hxml
+
+start-server:
+	node bin/server.js
+
+static:
+	haxe build-static.hxml
+	node bin/static-gen.js
+
+serve-static:
+	cd bin/static && python -m http.server 8043

samples/docs/package.json

@@ -0,0 +1,7 @@
+{
+  "dependencies": {
+    "jsdom": "19.0.0",
+    "react": "18.2.0",
+    "react-dom": "18.2.0"
+  }
+}