@ecopages/ecopages-jsx 0.2.0-beta.25 → 0.2.0-beta.27

package/README.md

@@ -99,6 +99,7 @@ Ecopages JSX can own the outer page shell or just a nested foreign subtree. When
 
 Important:
 
+- Cross-integration JSX children must use `EcoEmbed`. Opaque plain objects fail fast at core foreign-child queue boundaries; they are not coerced with `String(object)`.
 - 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 treat rendered HTML alone as the source of truth.
 - Ecopages JSX keeps raw-markup preservation and asset collection inside the JSX renderer.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/ecopages-jsx",
-  "version": "0.2.0-beta.25",
+  "version": "0.2.0-beta.27",
   "description": "JSX integration plugin for Ecopages",
   "keywords": [
     "ecopages",
@@ -31,12 +31,12 @@
     "directory": "packages/integrations/ecopages-jsx"
   },
   "dependencies": {
-    "@ecopages/mdx": "0.2.0-beta.25",
+    "@ecopages/mdx": "0.2.0-beta.27",
     "@mdx-js/mdx": "^3.1.1",
     "vfile": "^6.0.3"
   },
   "peerDependencies": {
-    "@ecopages/core": "0.2.0-beta.25",
+    "@ecopages/core": "0.2.0-beta.27",
     "@ecopages/jsx": "0.3.0-beta.2",
     "@ecopages/radiant": "0.3.0-beta.2"
   }

package/src/ecopages-jsx-radiant-ssr-policy.d.ts

@@ -4,13 +4,14 @@ import { createMarkupNodeLike } from '@ecopages/jsx';
  *
  * @remarks
  * Radiant's server bridge and light-DOM shim are loaded lazily because most JSX
- * renders do not need them. Once enabled, the resolved runtime modules are
- * cached statically so repeated page and component renders do not keep paying
- * module-resolution or shim-installation costs.
+ * renders do not need them. Resolved runtime modules are cached on the policy
+ * instance so repeated renders on the same renderer reuse one load without
+ * process-wide mutable class state. Light-DOM constructor installation remains
+ * process-global and idempotent via {@link ensureRadiantLightDomGlobals}.
  */
 export declare class EcopagesJsxRadiantSsrPolicy {
-    private static runtimeModules;
-    private static runtimeModulesPromise;
+    private runtimeModules;
+    private runtimeModulesPromise;
     private readonly enabled;
     constructor(enabled: boolean);
     /**

package/src/ecopages-jsx-radiant-ssr-policy.js

@@ -1,8 +1,8 @@
 import { createMarkupNodeLike } from "@ecopages/jsx";
 import { createServerHydrationBindingState, withServerHydrationBindingState } from "@ecopages/jsx/server";
 class EcopagesJsxRadiantSsrPolicy {
-  static runtimeModules;
-  static runtimeModulesPromise;
+  runtimeModules;
+  runtimeModulesPromise;
   enabled;
   constructor(enabled) {
     this.enabled = enabled;
@@ -23,7 +23,7 @@ class EcopagesJsxRadiantSsrPolicy {
     if (!this.enabled) {
       return render();
     }
-    const runtimeModules = await EcopagesJsxRadiantSsrPolicy.runtimeModulesPromise;
+    const runtimeModules = await this.runtimeModulesPromise;
     if (!runtimeModules) {
       return render();
     }
@@ -37,7 +37,7 @@ class EcopagesJsxRadiantSsrPolicy {
    * generated host HTML without escaping it back into plain text.
    */
   renderIntrinsicElementMarkup(instance) {
-    const renderBridge = EcopagesJsxRadiantSsrPolicy.runtimeModules?.resolveRadiantElementRenderBridge(instance);
+    const renderBridge = this.runtimeModules?.resolveRadiantElementRenderBridge(instance);
     if (!renderBridge) {
       return void 0;
     }
@@ -51,13 +51,13 @@ class EcopagesJsxRadiantSsrPolicy {
     );
   }
   async ensureRuntimeInstalled() {
-    if (!EcopagesJsxRadiantSsrPolicy.runtimeModulesPromise) {
+    if (!this.runtimeModulesPromise) {
       const radiantLightDomShimEntry = import.meta.resolve("@ecopages/radiant/server/light-dom-shim");
       const radiantElementSsrRuntimeModuleUrl = new URL(
         "./radiant-element-ssr-bridge.js",
         radiantLightDomShimEntry
       ).href;
-      EcopagesJsxRadiantSsrPolicy.runtimeModulesPromise = (async () => {
+      this.runtimeModulesPromise = (async () => {
         const lightDomShimModule2 = await import(radiantLightDomShimEntry);
         ensureRadiantLightDomGlobals(lightDomShimModule2.installLightDomShim);
         const radiantElementSsrRuntimeModule = await import(radiantElementSsrRuntimeModuleUrl);
@@ -66,12 +66,12 @@ class EcopagesJsxRadiantSsrPolicy {
           resolveRadiantElementRenderBridge: radiantElementSsrRuntimeModule.resolveRadiantElementRenderBridge,
           withServerRadiantElementSsrRuntime: radiantElementSsrRuntimeModule.withServerRadiantElementSsrRuntime
         };
-        EcopagesJsxRadiantSsrPolicy.runtimeModules = modules;
+        this.runtimeModules = modules;
         return modules;
       })();
     }
-    await EcopagesJsxRadiantSsrPolicy.runtimeModulesPromise;
-    const lightDomShimModule = EcopagesJsxRadiantSsrPolicy.runtimeModules;
+    await this.runtimeModulesPromise;
+    const lightDomShimModule = this.runtimeModules;
     if (lightDomShimModule) {
       ensureRadiantLightDomGlobals(lightDomShimModule.installLightDomShim);
     }

package/src/ecopages-jsx-render-session.d.ts

@@ -24,13 +24,6 @@ export declare class EcopagesJsxRenderSession {
      * JSX SSR scope bridge.
      */
     withActiveScope<T>(render: () => T): T;
-    /**
-     * Runs work with the current page-level hydrate binding namespace attached to JSX SSR.
-     *
-     * This lets page, layout, and document renders participate in one client-owned
-     * hydration root even though Ecopages composes them through multiple sibling render calls.
-     */
-    withHydrationBindingScope<T>(render: () => T): T;
     beginCollectedAssetFrame(): ProcessedAsset[];
     endCollectedAssetFrame(frame: ProcessedAsset[]): ProcessedAsset[];
     recordCollectedAssets(collectedAssets: ProcessedAsset[]): ProcessedAsset[];

package/src/ecopages-jsx-render-session.js

@@ -1,10 +1,5 @@
 import { AsyncLocalStorage } from "node:async_hooks";
-import {
-  createServerHydrationBindingState,
-  getActiveSsrScopeValue,
-  withActiveSsrScopeValue,
-  withServerHydrationBindingState
-} from "@ecopages/jsx/server";
+import { getActiveSsrScopeValue, withActiveSsrScopeValue } from "@ecopages/jsx/server";
 const ECOPAGES_JSX_SSR_RENDER_STATE_KEY = /* @__PURE__ */ Symbol.for("@ecopages/ecopages-jsx.ssr-render-state");
 const renderStateStorage = new AsyncLocalStorage();
 class EcopagesJsxRenderSession {
@@ -32,23 +27,13 @@ class EcopagesJsxRenderSession {
       return renderStateStorage.run(jsxScopeState, () => render());
     }
     const state = {
-      collectedAssetFrames: [],
-      hydrationBindingState: createServerHydrationBindingState()
+      collectedAssetFrames: []
     };
     return renderStateStorage.run(
       state,
       () => withActiveSsrScopeValue(ECOPAGES_JSX_SSR_RENDER_STATE_KEY, state, render)
     );
   }
-  /**
-   * Runs work with the current page-level hydrate binding namespace attached to JSX SSR.
-   *
-   * This lets page, layout, and document renders participate in one client-owned
-   * hydration root even though Ecopages composes them through multiple sibling render calls.
-   */
-  withHydrationBindingScope(render) {
-    return withServerHydrationBindingState(this.getState().hydrationBindingState, render);
-  }
   beginCollectedAssetFrame() {
     const state = this.getState();
     const frame = [];

package/src/ecopages-jsx-renderer.d.ts

@@ -16,7 +16,21 @@ export declare class EcopagesJsxRenderer extends IntegrationRenderer<JsxRenderab
     private readonly mdxExtensions;
     private readonly renderSession;
     private readonly radiantSsrPolicy;
+    /**
+     * Serializes foreign-child props for string-first boundaries.
+     *
+     * @remarks
+     * DOM nodes become `outerHTML`. JSX trees, arrays, and template results are
+     * stringified here. Other values are left for core foreign-child interception,
+     * which rejects opaque plain objects before queueing. Cross-integration
+     * children must use `EcoEmbed`.
+     */
     private normalizeForeignChildProps;
+    /**
+     * Returns whether children are a JSX/template shape this renderer can
+     * serialize before foreign-child queueing.
+     */
+    private isJsxSerializableForeignChild;
     /**
      * Re-renders queued JSX children inside the owning renderer so nested custom
      * elements and queued foreign subtrees contribute assets to the same frame.

package/src/ecopages-jsx-renderer.js

@@ -16,6 +16,15 @@ class EcopagesJsxRenderer extends IntegrationRenderer {
   mdxExtensions;
   renderSession;
   radiantSsrPolicy;
+  /**
+   * Serializes foreign-child props for string-first boundaries.
+   *
+   * @remarks
+   * DOM nodes become `outerHTML`. JSX trees, arrays, and template results are
+   * stringified here. Other values are left for core foreign-child interception,
+   * which rejects opaque plain objects before queueing. Cross-integration
+   * children must use `EcoEmbed`.
+   */
   normalizeForeignChildProps(props) {
     if (!("children" in props)) {
       return props;
@@ -30,10 +39,29 @@ class EcopagesJsxRenderer extends IntegrationRenderer {
         children: children.outerHTML
       };
     }
-    return {
-      ...props,
-      children: renderToString(children)
-    };
+    if (this.isJsxSerializableForeignChild(children)) {
+      return {
+        ...props,
+        children: renderToString(children)
+      };
+    }
+    return props;
+  }
+  /**
+   * Returns whether children are a JSX/template shape this renderer can
+   * serialize before foreign-child queueing.
+   */
+  isJsxSerializableForeignChild(children) {
+    if (Array.isArray(children)) {
+      return true;
+    }
+    if (children === null || typeof children !== "object") {
+      return false;
+    }
+    if ("$$typeof" in children) {
+      return true;
+    }
+    return "strings" in children && Array.isArray(children.strings);
   }
   /**
    * Re-renders queued JSX children inside the owning renderer so nested custom