feat: frontend docs

.npmrc

@@ -0,0 +1 @@
+legacy-peer-deps=true

Makefile

@@ -5,10 +5,12 @@ all: help
 
 dev:
 	@echo "Starting development mode..."
+	npm install
 	PYTHONPATH=$(CURDIR) uv run pipeline dev
 
 build:
 	@echo "Building documentation..."
+	npm install
 	PYTHONPATH=$(CURDIR) uv run pipeline build
 
 # Define a variable for the test file path.
@@ -64,6 +66,7 @@ test:
 install:
 	@echo "Installing all dependencies"
 	uv sync --all-groups
+	npm install
 	npm install -g mint@latest
 
 clean:

package.json

@@ -0,0 +1,9 @@
+{
+  "name": "docs",
+  "version": "1.0.0",
+  "description": "Docs for the project",
+  "private": true,
+  "dependencies": {
+    "@langchain/docs-sandbox": "0.0.5"
+  }
+}

pipeline/core/builder.py

@@ -51,6 +51,8 @@ def __init__(self, src_dir: Path, build_dir: Path) -> None:
             ".yaml",
             ".css",
             ".js",
+            ".jsx",
+            ".tsx",
             ".txt",
             ".woff2",
             ".woff",
@@ -103,6 +105,10 @@ def build_all(self) -> None:
         logger.info("Copying shared files...")
         self._copy_shared_files()
 
+        # Copy snippet components from @langchain/docs-sandbox npm package
+        logger.info("Copying npm snippet components...")
+        self._copy_npm_snippets()
+
         logger.info("✅ New structure build complete")
 
     def _convert_yaml_to_json(self, yaml_file_path: Path, output_path: Path) -> None:
@@ -819,6 +825,42 @@ def _copy_shared_files(self) -> None:
 
         logger.info("✅ Shared files copied: %d files", copied_count)
 
+    # Maps npm dist filenames to their output names in build/snippets/
+    _NPM_SNIPPET_FILES: dict[str, str] = {
+        "PatternEmbed.jsx": "pattern-embed.jsx",
+    }
+
+    def _copy_npm_snippets(self) -> None:
+        """Copy snippet components from the @langchain/docs-sandbox npm package.
+
+        Overwrites any source-tree versions already copied by _copy_shared_files
+        so the build always uses the latest published component.
+        """
+        pkg_dist = (
+            self.src_dir.parent
+            / "node_modules"
+            / "@langchain"
+            / "docs-sandbox"
+            / "dist"
+        )
+        if not pkg_dist.is_dir():
+            logger.warning(
+                "@langchain/docs-sandbox not installed — run `npm install` first"
+            )
+            return
+
+        snippets_dir = self.build_dir / "snippets"
+        snippets_dir.mkdir(parents=True, exist_ok=True)
+
+        for src_name, dest_name in self._NPM_SNIPPET_FILES.items():
+            src_file = pkg_dist / src_name
+            if not src_file.is_file():
+                logger.warning("Expected file not found in npm package: %s", src_file)
+                continue
+            dest_file = snippets_dir / dest_name
+            shutil.copy2(src_file, dest_file)
+            logger.info("Copied npm snippet: %s → snippets/%s", src_name, dest_name)
+
     def _process_snippet_markdown_file(
         self, input_path: Path, output_path: Path
     ) -> None:

src/docs.json

@@ -991,14 +991,16 @@
                         "oss/python/deepagents/human-in-the-loop",
                         "oss/python/deepagents/long-term-memory",
                         "oss/python/deepagents/skills",
-                        "oss/python/deepagents/sandboxes"
+                        "oss/python/deepagents/sandboxes",
+                        "oss/python/deepagents/streaming"
                       ]
                     },
                     {
-                      "group": "Streaming",
+                      "group": "Frontend",
                       "pages": [
-                        "oss/python/deepagents/streaming/overview",
-                        "oss/python/deepagents/streaming/frontend"
+                        "oss/python/deepagents/frontend/overview",
+                        "oss/python/deepagents/frontend/subagent-streaming",
+                        "oss/python/deepagents/frontend/todo-list"
                       ]
                     },
                     {
@@ -1039,13 +1041,7 @@
                         "oss/python/langchain/messages",
                         "oss/python/langchain/tools",
                         "oss/python/langchain/short-term-memory",
-                        {
-                          "group": "Streaming",
-                          "pages": [
-                            "oss/python/langchain/streaming/overview",
-                            "oss/python/langchain/streaming/frontend"
-                          ]
-                        },
+                        "oss/python/langchain/streaming",
                         "oss/python/langchain/structured-output"
                       ]
                     },
@@ -1057,6 +1053,22 @@
                         "oss/python/langchain/middleware/custom"
                       ]
                     },
+                    {
+                      "group": "Frontend",
+                      "pages": [
+                        "oss/python/langchain/frontend/overview",
+                        "oss/python/langchain/frontend/markdown-messages",
+                        "oss/python/langchain/frontend/tool-calling",
+                        "oss/python/langchain/frontend/human-in-the-loop",
+                        "oss/python/langchain/frontend/branching-chat",
+                        "oss/python/langchain/frontend/reasoning-tokens",
+                        "oss/python/langchain/frontend/structured-output",
+                        "oss/python/langchain/frontend/message-queues",
+                        "oss/python/langchain/frontend/join-rejoin",
+                        "oss/python/langchain/frontend/time-travel",
+                        "oss/python/langchain/frontend/generative-ui"
+                      ]
+                    },
                     {
                       "group": "Advanced usage",
                       "pages": [
@@ -1143,6 +1155,13 @@
                         "oss/python/langgraph/observability"
                       ]
                     },
+                    {
+                      "group": "Frontend",
+                      "pages": [
+                        "oss/python/langgraph/frontend/overview",
+                        "oss/python/langgraph/frontend/graph-execution"
+                      ]
+                    },
                     {
                       "group": "LangGraph APIs",
                       "pages": [
@@ -1381,11 +1400,13 @@
                         "oss/javascript/deepagents/sandboxes"
                       ]
                     },
+                    "oss/javascript/deepagents/streaming",
                     {
-                      "group": "Streaming",
+                      "group": "Frontend",
                       "pages": [
-                        "oss/javascript/deepagents/streaming/overview",
-                        "oss/javascript/deepagents/streaming/frontend"
+                        "oss/javascript/deepagents/frontend/overview",
+                        "oss/javascript/deepagents/frontend/subagent-streaming",
+                        "oss/javascript/deepagents/frontend/todo-list"
                       ]
                     },
                     {
@@ -1418,16 +1439,26 @@
                         "oss/javascript/langchain/messages",
                         "oss/javascript/langchain/tools",
                         "oss/javascript/langchain/short-term-memory",
-                        {
-                          "group": "Streaming",
-                          "pages": [
-                            "oss/javascript/langchain/streaming/overview",
-                            "oss/javascript/langchain/streaming/frontend"
-                          ]
-                        },
+                        "oss/javascript/langchain/streaming",
                         "oss/javascript/langchain/structured-output"
                       ]
                     },
+                    {
+                      "group": "Frontend",
+                      "pages": [
+                        "oss/javascript/langchain/frontend/overview",
+                        "oss/javascript/langchain/frontend/markdown-messages",
+                        "oss/javascript/langchain/frontend/tool-calling",
+                        "oss/javascript/langchain/frontend/human-in-the-loop",
+                        "oss/javascript/langchain/frontend/branching-chat",
+                        "oss/javascript/langchain/frontend/reasoning-tokens",
+                        "oss/javascript/langchain/frontend/structured-output",
+                        "oss/javascript/langchain/frontend/message-queues",
+                        "oss/javascript/langchain/frontend/join-rejoin",
+                        "oss/javascript/langchain/frontend/time-travel",
+                        "oss/javascript/langchain/frontend/generative-ui"
+                      ]
+                    },
                     {
                       "group": "Middleware",
                       "pages": [
@@ -1522,6 +1553,13 @@
                         "oss/javascript/langgraph/observability"
                       ]
                     },
+                    {
+                      "group": "Frontend",
+                      "pages": [
+                        "oss/javascript/langgraph/frontend/overview",
+                        "oss/javascript/langgraph/frontend/graph-execution"
+                      ]
+                    },
                     {
                       "group": "LangGraph APIs",
                       "pages": [
@@ -1889,12 +1927,20 @@
       "destination": "/oss/javascript/langchain/test/evals"
     },
     {
-      "source": "/oss/python/deepagents/streaming",
-      "destination": "/oss/python/deepagents/streaming/overview"
+      "source": "/oss/python/deepagents/streaming/overview",
+      "destination": "/oss/python/deepagents/streaming"
+    },
+    {
+      "source": "/oss/javascript/deepagents/streaming/overview",
+      "destination": "/oss/javascript/deepagents/streaming"
     },
     {
-      "source": "/oss/javascript/deepagents/streaming",
-      "destination": "/oss/javascript/deepagents/streaming/overview"
+      "source": "/oss/python/deepagents/streaming/frontend",
+      "destination": "/oss/python/deepagents/frontend/overview"
+    },
+    {
+      "source": "/oss/javascript/deepagents/streaming/frontend",
+      "destination": "/oss/javascript/deepagents/frontend/overview"
     },
     {
       "source": "/langsmith",
@@ -2189,16 +2235,24 @@
       "destination": "/oss/javascript/langchain/middleware/overview"
     },
     {
-      "source": "/oss/python/langchain/streaming",
-      "destination": "/oss/python/langchain/streaming/overview"
+      "source": "/oss/python/langchain/streaming/overview",
+      "destination": "/oss/python/langchain/streaming"
+    },
+    {
+      "source": "/oss/javascript/langchain/streaming/overview",
+      "destination": "/oss/javascript/langchain/streaming"
+    },
+    {
+      "source": "/oss/python/langchain/streaming/frontend",
+      "destination": "/oss/python/langchain/frontend/overview"
     },
     {
-      "source": "/oss/javascript/langchain/streaming",
-      "destination": "/oss/javascript/langchain/streaming/overview"
+      "source": "/oss/javascript/langchain/streaming/frontend",
+      "destination": "/oss/javascript/langchain/frontend/overview"
     },
     {
       "source": "/langsmith/use-stream-react",
-      "destination": "/oss/langchain/streaming/frontend"
+      "destination": "/oss/langchain/frontend/overview"
     },
     {
       "source": "/oss/python/integrations/tools/toolbox",