@ecopages/react 0.2.0-alpha.16 → 0.2.0-alpha.18

package/CHANGELOG.md

@@ -10,6 +10,7 @@ All notable changes to `@ecopages/react` are documented here.
 
 - Fixed React hydration, Fast Refresh, module loading, doctype handling, island asset reuse, and mixed-renderer boundary resolution across Bun, Vite, and Nitro flows.
 - Restored direct `ReactPlugin` construction so the exported class still accepts the public plugin options shape.
+- Fixed React boundary payload compatibility coverage and removed the plugin/renderer integration-name import cycle.
 
 ### Features
 
@@ -28,6 +29,7 @@ All notable changes to `@ecopages/react` are documented here.
 
 - Added Vitest browser coverage for the React `dynamic()` utility using React Testing Library.
 - Added browser execution coverage for the generated React hydration bootstrap, including router ownership registration and page-root cleanup.
+- Added renderer-level coverage for the boundary payload compatibility contract, including non-attachable fragment roots.
 
 ### Documentation
 

package/README.md

@@ -70,6 +70,12 @@ The React integration can participate in mixed-renderer apps in three ways:
 
 When a non-React render pass enters a React-owned boundary, Ecopages hands that boundary back to the React renderer. When React renders through a non-React shell, that shell must serialize to HTML so React can insert the result into the final response without escaping it.
 
+Important:
+
+- Components that may render foreign children must declare those children in `config.dependencies.components`.
+- Ecopages validates mixed-renderer ownership from declared dependencies during render preparation. It does not infer every foreign boundary from rendered HTML alone.
+- React still keeps its own child transport and hydration rules for React-owned subtrees.
+
 ## Server and Client Graph Contract
 
 The React integration supports Node.js modules and server-only code **only on the server execution graph**.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/react",
-  "version": "0.2.0-alpha.16",
+  "version": "0.2.0-alpha.18",
   "description": "React integration for Ecopages",
   "keywords": [
     "ecopages",
@@ -53,14 +53,14 @@
     "directory": "packages/integrations/react"
   },
   "peerDependencies": {
-    "@ecopages/core": "0.2.0-alpha.16",
+    "@ecopages/core": "0.2.0-alpha.18",
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "react": "^19",
     "react-dom": "^19"
   },
   "dependencies": {
-    "@ecopages/file-system": "0.2.0-alpha.16",
+    "@ecopages/file-system": "0.2.0-alpha.18",
     "@ecopages/logger": "^0.2.3",
     "@mdx-js/esbuild": "^3.0.1",
     "@mdx-js/mdx": "^3.1.0",

package/src/react-renderer.js

@@ -6,7 +6,7 @@ import { getAppBuildExecutor } from "@ecopages/core/build/build-adapter";
 import { ECO_DOCUMENT_OWNER_ATTRIBUTE } from "@ecopages/core/router/navigation-coordinator";
 import { createRequire } from "node:module";
 import path from "node:path";
-import { PLUGIN_NAME } from "./react.plugin.js";
+import { REACT_PLUGIN_NAME } from "./react.constants.js";
 import { hasSingleRootElement } from "./utils/html-boundary.js";
 import { ReactBundleService } from "./services/react-bundle.service.js";
 import { ReactHmrPageMetadataCache } from "./services/react-hmr-page-metadata-cache.js";
@@ -29,7 +29,7 @@ class BundleError extends Error {
   }
 }
 class ReactRenderer extends IntegrationRenderer {
-  name = PLUGIN_NAME;
+  name = REACT_PLUGIN_NAME;
   componentDirectory = RESOLVED_ASSETS_DIR;
   reactRuntimeModules;
   routerAdapter;

package/src/react.constants.d.ts

@@ -0,0 +1 @@
+export declare const REACT_PLUGIN_NAME = "react";

package/src/react.constants.js

@@ -0,0 +1,4 @@
+const REACT_PLUGIN_NAME = "react";
+export {
+  REACT_PLUGIN_NAME
+};

package/src/react.plugin.js

@@ -1,11 +1,12 @@
 import { IntegrationPlugin } from "@ecopages/core/plugins/integration-plugin";
 import { Logger } from "@ecopages/logger";
+import { REACT_PLUGIN_NAME } from "./react.constants.js";
 import { ReactRenderer } from "./react-renderer.js";
 import { ReactHmrStrategy } from "./react-hmr-strategy.js";
 import { ReactRuntimeBundleService } from "./services/react-runtime-bundle.service.js";
 import { ReactHmrPageMetadataCache } from "./services/react-hmr-page-metadata-cache.js";
 const appLogger = new Logger("[ReactPlugin]");
-const PLUGIN_NAME = "react";
+const PLUGIN_NAME = REACT_PLUGIN_NAME;
 const mergePluginLists = (...lists) => {
   const merged = lists.flatMap((list) => list ? [...list] : []);
   return merged.length > 0 ? merged : void 0;