@ecopages/mdx 0.2.0-alpha.15 → 0.2.0-alpha.17

package/CHANGELOG.md

@@ -13,11 +13,16 @@ All notable changes to `@ecopages/mdx` are documented here.
 ### Bug Fixes
 
 - Fixed loader registration, Node `source-map` interop, and renderer-owned mixed-boundary rendering for standalone MDX routes.
+- Fixed standalone MDX boundary payload compatibility coverage and removed the plugin/renderer integration-name import cycle.
 
 ### Documentation
 
 - Updated the README for standalone non-React MDX usage, `.md` opt-in handling, and compiler configuration.
 
+### Tests
+
+- Added renderer-level coverage for the boundary payload compatibility contract.
+
 ### Refactoring
 
 - Replaced the standalone MDX renderer factory with explicit renderer-owned compiler configuration and collected shared MDX plugin and renderer types into a dedicated module.

package/README.md

@@ -65,6 +65,16 @@ mdxPlugin({
 > [!WARNING]
 > React runtimes are intentionally rejected by this standalone plugin.
 
+## Mixed Rendering
+
+Standalone MDX can own the page shell or nested MDX component boundaries in a mixed-renderer app. When another integration reaches an MDX-owned boundary, Ecopages hands that boundary back to the MDX renderer so the MDX runtime can finish serialization before the outer renderer resumes.
+
+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 rather than inferring every boundary from rendered HTML alone.
+- Standalone MDX keeps its own page normalization and non-React JSX runtime behavior.
+
 ## Using MDX with React
 
 If you are using `@ecopages/react` and building a full React application, **do not** use this standalone MDX plugin. Instead, enable MDX directly within the React plugin configuration to ensure unified hydration, client-side routing, and HMR:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/mdx",
-  "version": "0.2.0-alpha.15",
+  "version": "0.2.0-alpha.17",
   "description": "MDX plugin for Ecopages",
   "keywords": [
     "ecopages",
@@ -37,7 +37,7 @@
     "directory": "packages/integrations/mdx"
   },
   "peerDependencies": {
-    "@ecopages/core": "0.2.0-alpha.15",
+    "@ecopages/core": "0.2.0-alpha.17",
     "@kitajs/html": "^4.1.0",
     "@mdx-js/mdx": "^3.1.0"
   },

package/src/mdx-renderer.js

@@ -1,9 +1,9 @@
 import { IntegrationRenderer } from "@ecopages/core/route-renderer/integration-renderer";
 import { invariant } from "@ecopages/core/utils/invariant";
-import { PLUGIN_NAME } from "./mdx.plugin.js";
+import { MDX_PLUGIN_NAME } from "./mdx.constants.js";
 import { rapidhash } from "@ecopages/core/hash";
 class MDXRenderer extends IntegrationRenderer {
-  name = PLUGIN_NAME;
+  name = MDX_PLUGIN_NAME;
   compilerOptions;
   constructor({ mdxConfig, ...options }) {
     super(options);

package/src/mdx.constants.d.ts

@@ -0,0 +1 @@
+export declare const MDX_PLUGIN_NAME = "MDX";

package/src/mdx.constants.js

@@ -0,0 +1,4 @@
+const MDX_PLUGIN_NAME = "MDX";
+export {
+  MDX_PLUGIN_NAME
+};

package/src/mdx.plugin.js

@@ -2,9 +2,10 @@ import { IntegrationPlugin } from "@ecopages/core/plugins/integration-plugin";
 import { deepMerge } from "@ecopages/core/utils/deep-merge";
 import { Logger } from "@ecopages/logger";
 import { createMdxLoaderPlugin } from "./mdx-loader-plugin.js";
+import { MDX_PLUGIN_NAME } from "./mdx.constants.js";
 import { MDXRenderer } from "./mdx-renderer.js";
 const appLogger = new Logger("[MDXPlugin]");
-const PLUGIN_NAME = "MDX";
+const PLUGIN_NAME = MDX_PLUGIN_NAME;
 const defaultOptions = {
   format: "detect",
   outputFormat: "program",