rework docs extension + misc changes

Author: rmorshea

docs/source/_custom_js/package-lock.json

@@ -1,12 +1,12 @@
-import { mountWithLayoutServer, LayoutServerInfo } from "@reactpy/client";
+import { SimpleReactPyClient, mount } from "@reactpy/client";
 
 let didMountDebug = false;
 
 export function mountWidgetExample(
   mountID,
   viewID,
   reactpyServerHost,
-  useActivateButton
+  useActivateButton,
 ) {
   let reactpyHost, reactpyPort;
   if (reactpyServerHost) {
@@ -16,27 +16,27 @@ export function mountWidgetExample(
     reactpyPort = window.location.port;
   }
 
-  const serverInfo = new LayoutServerInfo({
-    host: reactpyHost,
-    port: reactpyPort,
-    path: "/_reactpy/",
-    query: `view_id=${viewID}`,
-    secure: window.location.protocol == "https:",
+  const client = new SimpleReactPyClient({
+    serverLocation: {
+      url: `${window.location.protocol}//${reactpyHost}:${reactpyPort}`,
+      route: "/",
+      query: `?view_id=${viewID}`,
+    },
   });
 
   const mountEl = document.getElementById(mountID);
   let isMounted = false;
   triggerIfInViewport(mountEl, () => {
     if (!isMounted) {
-      activateView(mountEl, serverInfo, useActivateButton);
+      activateView(mountEl, client, useActivateButton);
       isMounted = true;
     }
   });
 }
 
-function activateView(mountEl, serverInfo, useActivateButton) {
+function activateView(mountEl, client, useActivateButton) {
   if (!useActivateButton) {
-    mountWithLayoutServer(mountEl, serverInfo);
+    mount(mountEl, client);
     return;
   }
 
@@ -51,7 +51,7 @@ function activateView(mountEl, serverInfo, useActivateButton) {
         mountEl.setAttribute("class", "interactive widget-container");
         mountWithLayoutServer(mountEl, serverInfo);
       }
-    })
+    }),
   );
 
   function fadeOutElementThenCallback(element, callback) {
@@ -87,7 +87,7 @@ function triggerIfInViewport(element, callback) {
     {
       root: null,
       threshold: 0.1, // set offset 0.1 means trigger if atleast 10% of element in viewport
-    }
+    },
   );
 
   observer.observe(element);

docs/source/_custom_js/src/index.js

@@ -35,7 +35,6 @@ def __call__(self, session: Session) -> Callable[[bool], None]:
 SRC_DIR = ROOT_DIR / "src"
 CLIENT_DIR = SRC_DIR / "client"
 REACTPY_DIR = SRC_DIR / "reactpy"
-LANGUAGE_TYPES: list[LanguageName] = ["py", "js"]
 TAG_PATTERN = re.compile(
     # start
     r"^"
@@ -46,7 +45,6 @@ def __call__(self, session: Session) -> Callable[[bool], None]:
     # end
     r"$"
 )
-print(TAG_PATTERN.pattern)
 REMAINING_ARGS = Option(nargs=REMAINDER, type=str)
 
 
@@ -89,6 +87,12 @@ def format(session: Session) -> None:
     session.run("npm", "run", "format", external=True)
 
 
+@group.session
+def tsc(session: Session) -> None:
+    session.chdir(CLIENT_DIR)
+    session.run("npx", "tsc", "-b", "-w", "packages/app", external=True)
+
+
 @group.session
 def example(session: Session) -> None:
     """Run an example"""
@@ -269,16 +273,38 @@ def build_python(session: Session) -> None:
 
 
 @group.session
-def publish(session: Session, dry_run: bool = False) -> None:
+def publish(
+    session: Session,
+    publish_dry_run: Annotated[
+        bool,
+        Option(help="whether to test the release process"),
+    ] = False,
+    publish_fake_tags: Annotated[
+        Sequence[str],
+        Option(nargs="*", type=str, help="fake tags to use for a dry run release"),
+    ] = (),
+) -> None:
     packages = get_packages(session)
 
     release_prep: dict[LanguageName, ReleasePrepFunc] = {
         "js": prepare_javascript_release,
         "py": prepare_python_release,
     }
 
+    if publish_fake_tags and not publish_dry_run:
+        session.error("Cannot specify --publish-fake-tags without --publish-dry-run")
+
+    parsed_tags: list[TagInfo] = []
+    for tag in publish_fake_tags or get_current_tags(session):
+        tag_info = parse_tag(tag)
+        if tag_info is None:
+            session.error(
+                f"Invalid tag {tag} - must be of the form <package>-<language>-<version>"
+            )
+        parsed_tags.append(tag_info)
+
     publishers: list[tuple[Path, Callable[[bool], None]]] = []
-    for tag, tag_pkg, tag_ver in get_current_tags(session):
+    for tag, tag_pkg, tag_ver in parsed_tags:
         if tag_pkg not in packages:
             session.error(f"Tag {tag} references package {tag_pkg} that does not exist")
 
@@ -296,7 +322,7 @@ def publish(session: Session, dry_run: bool = False) -> None:
     for pkg_path, publish in publishers:
         session.log(f"Publishing {pkg_path}...")
         session.chdir(pkg_path)
-        publish(dry_run)
+        publish(publish_dry_run)
 
 
 # --- Utilities ------------------------------------------------------------------------
@@ -420,7 +446,7 @@ class PackageInfo(NamedTuple):
     version: str
 
 
-def get_current_tags(session: Session) -> list[TagInfo]:
+def get_current_tags(session: Session) -> list[str]:
     """Get tags for the current commit"""
     # check if unstaged changes
     try:
@@ -468,24 +494,20 @@ def get_current_tags(session: Session) -> list[TagInfo]:
     if not tags:
         session.error("No tags found for current commit")
 
-    parsed_tags: list[TagInfo] = []
-    for tag in tags:
-        match = TAG_PATTERN.match(tag)
-        if not match:
-            session.error(
-                f"Invalid tag {tag} - must be of the form <package>-<language>-<version>"
-            )
-        parsed_tags.append(
-            TagInfo(
-                tag,
-                match["name"],  # type: ignore[index]
-                match["version"],  # type: ignore[index]
-            )
-        )
+    session.log(f"Found tags: {tags}")
 
-    session.log(f"Found tags: {[info.tag for info in parsed_tags]}")
+    return tags
 
-    return parsed_tags
+
+def parse_tag(tag: str) -> TagInfo | None:
+    match = TAG_PATTERN.match(tag)
+    if not match:
+        return None
+    return TagInfo(
+        tag,
+        match["name"],  # type: ignore[index]
+        match["version"],  # type: ignore[index]
+    )
 
 
 class TagInfo(NamedTuple):

noxfile.py

@@ -1 +1,2 @@
 tsconfig.tsbuildinfo
+packages/**/package-lock.json