@ecopages/mdx 0.2.0-alpha.26 → 0.2.0-alpha.27

package/CHANGELOG.md

@@ -12,8 +12,8 @@ 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.
+- Fixed loader registration, Node `source-map` interop, and renderer-owned mixed foreign-subtree rendering for standalone MDX routes.
+- Fixed standalone MDX foreign-subtree payload compatibility coverage and removed the plugin/renderer integration-name import cycle.
 
 ### Documentation
 
@@ -21,7 +21,7 @@ All notable changes to `@ecopages/mdx` are documented here.
 
 ### Tests
 
-- Added renderer-level coverage for the boundary payload compatibility contract.
+- Added renderer-level coverage for the foreign-subtree payload compatibility contract.
 
 ### Refactoring
 

package/README.md

@@ -5,9 +5,11 @@ Integration plugin for standalone MDX support in Ecopages for non-React JSX runt
 ## Installation
 
 ```bash
-bun add @ecopages/mdx
+bun add @ecopages/mdx @kitajs/html @mdx-js/mdx
 ```
 
+`@kitajs/html` and `@mdx-js/mdx` are required peer dependencies for this package.
+
 ## Usage
 
 Import and apply the `mdxPlugin` in your `eco.config.ts`:
@@ -67,12 +69,12 @@ mdxPlugin({
 
 ## 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.
+Standalone MDX can own the page shell or nested MDX foreign subtrees in a mixed-renderer app. When another integration reaches an MDX-owned foreign child, Ecopages hands that foreign subtree 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.
+- Ecopages validates mixed-renderer ownership from declared dependencies during render preparation rather than inferring every foreign subtree from rendered HTML alone.
 - Standalone MDX keeps its own page normalization and non-React JSX runtime behavior.
 
 ## Using MDX with React

package/package.json

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

package/src/mdx-loader-plugin.d.ts

@@ -1,3 +1,3 @@
-import type { EcoBuildPlugin } from '@ecopages/core/build/build-types';
+import type { EcoBuildPlugin } from '@ecopages/core/plugins/integration-plugin';
 import { type CompileOptions } from '@mdx-js/mdx';
 export declare function createMdxLoaderPlugin(compilerOptions?: CompileOptions): EcoBuildPlugin;

package/src/mdx-renderer.d.ts

@@ -21,13 +21,11 @@ export declare class MDXRenderer extends IntegrationRenderer<EcoPagesElement> {
     readonly compilerOptions: CompileOptions;
     private isFunctionComponent;
     constructor({ mdxConfig, ...options }: MDXRendererOptions);
-    buildRouteRenderAssets(pagePath: string): Promise<ProcessedAsset[]>;
+    buildPageBrowserGraph(pagePath: string): Promise<{
+        assets: ProcessedAsset[];
+    }>;
     protected normalizeImportedPageFile<TPageModule extends EcoPageFile>(_file: string, pageModule: TPageModule): TPageModule;
     renderComponent(input: ComponentRenderInput): Promise<ComponentRenderResult>;
-    protected createComponentBoundaryRuntime(options: {
-        boundaryInput: ComponentRenderInput;
-        rendererCache: Map<string, IntegrationRenderer<any>>;
-    }): import("@ecopages/core").ComponentBoundaryRuntime;
     render({ params, query, props, locals, pageLocals, metadata, Page, HtmlTemplate, Layout, pageProps, }: MDXIntegrationRendererOptions): Promise<RouteRendererBody>;
     renderToResponse<P = Record<string, unknown>>(view: EcoComponent<P>, props: P, ctx: RenderToResponseContext): Promise<Response>;
 }

package/src/mdx-renderer.js

@@ -1,5 +1,5 @@
+import { assertIntegrationInvariant } from "@ecopages/core/plugins/integration-plugin";
 import { IntegrationRenderer } from "@ecopages/core/route-renderer/integration-renderer";
-import { invariant } from "@ecopages/core/utils/invariant";
 import { MDX_PLUGIN_NAME } from "./mdx.constants.js";
 import { rapidhash } from "@ecopages/core/hash";
 class MDXRenderer extends IntegrationRenderer {
@@ -12,7 +12,7 @@ class MDXRenderer extends IntegrationRenderer {
     super(options);
     this.compilerOptions = mdxConfig?.compilerOptions ?? {};
   }
-  async buildRouteRenderAssets(pagePath) {
+  async buildPageBrowserGraph(pagePath) {
     const { default: pageComponent } = await this.importPageFile(pagePath);
     const config = pageComponent.config;
     const components = [];
@@ -32,7 +32,9 @@ class MDXRenderer extends IntegrationRenderer {
         }
       });
     }
-    return await this.resolveDependencies(components);
+    return {
+      assets: await this.resolveDependencies(components)
+    };
   }
   normalizeImportedPageFile(_file, pageModule) {
     try {
@@ -50,20 +52,14 @@ class MDXRenderer extends IntegrationRenderer {
         getMetadata
       };
     } catch (error) {
-      invariant(false, `Error importing MDX file: ${error}`);
+      assertIntegrationInvariant(false, `Error importing MDX file: ${error}`);
     }
   }
   async renderComponent(input) {
     if (!this.isFunctionComponent(input.component)) {
       throw new TypeError("MDX renderer expected a callable component.");
     }
-    return this.renderStringComponentBoundaryWithQueuedForeignBoundaries(input, input.component);
-  }
-  createComponentBoundaryRuntime(options) {
-    return this.createQueuedBoundaryRuntime({
-      boundaryInput: options.boundaryInput,
-      rendererCache: options.rendererCache
-    });
+    return this.renderStringComponentWithQueuedForeignSubtrees(input, input.component);
   }
   async render({
     params,

package/src/mdx.plugin.d.ts

@@ -1,6 +1,5 @@
-import type { EcoBuildPlugin } from '@ecopages/core/build/build-types';
 import type { EcoPagesElement } from '@ecopages/core';
-import { IntegrationPlugin } from '@ecopages/core/plugins/integration-plugin';
+import { IntegrationPlugin, type EcoBuildPlugin } from '@ecopages/core/plugins/integration-plugin';
 import { MDXRenderer } from './mdx-renderer.js';
 import type { MDXPluginConfig } from './mdx.types.js';
 export type { MDXPluginConfig, MDXRendererConfig, MDXRendererOptions } from './mdx.types.js';

package/src/mdx.plugin.js

@@ -1,5 +1,7 @@
-import { IntegrationPlugin } from "@ecopages/core/plugins/integration-plugin";
-import { deepMerge } from "@ecopages/core/utils/deep-merge";
+import {
+  IntegrationPlugin,
+  mergeIntegrationOptions
+} from "@ecopages/core/plugins/integration-plugin";
 import { Logger } from "@ecopages/logger";
 import { createMdxLoaderPlugin } from "./mdx-loader-plugin.js";
 import { MDX_PLUGIN_NAME } from "./mdx.constants.js";
@@ -36,7 +38,7 @@ class MDXPlugin extends IntegrationPlugin {
       ...options
     });
     const { mdExtensions, mdxExtensions } = splitMarkdownExtensions(this.extensions);
-    const finalCompilerOptions = deepMerge(
+    const finalCompilerOptions = mergeIntegrationOptions(
       {
         ...defaultOptions,
         mdxExtensions,

package/src/mdx.types.d.ts

@@ -1,5 +1,4 @@
-import type { EcoComponent, EcoComponentConfig, GetMetadata } from '@ecopages/core';
-import type { EcoPagesAppConfig } from '@ecopages/core/internal-types';
+import type { EcoComponent, EcoComponentConfig, EcoPagesAppConfig, GetMetadata } from '@ecopages/core';
 import type { IntegrationPluginConfig } from '@ecopages/core/plugins/integration-plugin';
 import type { AssetProcessingService, ProcessedAsset } from '@ecopages/core/services/asset-processing-service';
 import type { CompileOptions } from '@mdx-js/mdx';