[codex] Add typed route slots (#197)

* Add typed route slots

* Format route slot changes

* Normalize router package bin

* Add route slots changeset

Author: zth

.changeset/typed-route-slots.md

@@ -0,0 +1,7 @@
+---
+"rescript-relay-router": minor
+---
+
+Add typed route slots for rendering descendant route branches into named parent outlets.
+
+Routes can now declare `slots`, descendant routes can target an ancestor slot with `outlet`, and generated route modules expose typed slot components such as `Routes.Root.Slots.Overlay`.

examples/client-rendering/src/components/Layout.res

@@ -4,7 +4,10 @@ module Query = %relay(`
   }
 `)
 
-let links = [("Todos", Routes.Root.Todos.Route.makeLink())]
+let links = [
+  ("Todos", Routes.Root.Todos.Route.makeLink()),
+  ("Settings overlay", Routes.Root.Settings.Route.makeLink()),
+]
 
 @react.component
 let make = (~queryRef, ~children) => {
@@ -22,5 +25,6 @@ let make = (~queryRef, ~children) => {
     <React.Suspense fallback={<div> {React.string("Loading...")} </div>}>
       <LayoutDisplay query={data.fragmentRefs}> {children} </LayoutDisplay>
     </React.Suspense>
+    <Routes.Root.Slots.Overlay />
   </div>
 }

examples/client-rendering/src/routes/Root__Settings_route_renderer.res

@@ -0,0 +1,9 @@
+let renderer = Route__Root__Settings_route.makeRenderer(
+  ~prepare=_props => (),
+  ~render=_props => {
+    <aside>
+      <h2> {React.string("Settings")} </h2>
+      <p> {React.string("This route renders through Routes.Root.Slots.Overlay.")} </p>
+    </aside>
+  },
+)