@ecopages/ecopages-jsx 0.2.0-rc.3 → 0.2.0-rc.5

package/README.md

@@ -100,7 +100,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)`.
+- Cross-integration shell stacks should use `EcoEmbed` from `@ecopages/ecopages-jsx/eco-embed` (or the matching integration adapter). Plain opaque objects fail fast at core foreign-subtree queue boundaries; they are not coerced with `String(object)`. Pass already-serialized HTML when `EcoEmbed` is not needed.
 - 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-rc.3",
+  "version": "0.2.0-rc.5",
   "description": "JSX integration plugin for Ecopages",
   "keywords": [
     "ecopages",
@@ -11,6 +11,9 @@
   "main": "./src/ecopages-jsx.plugin.js",
   "types": "./src/ecopages-jsx.plugin.d.ts",
   "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
     ".": {
       "default": "./src/ecopages-jsx.plugin.js",
@@ -31,13 +34,13 @@
     "directory": "packages/integrations/ecopages-jsx"
   },
   "dependencies": {
-    "@ecopages/mdx": "0.2.0-rc.3",
+    "@ecopages/mdx": "0.2.0-rc.5",
     "@mdx-js/mdx": "^3.1.1",
     "vfile": "^6.0.3"
   },
   "peerDependencies": {
-    "@ecopages/core": "0.2.0-rc.3",
+    "@ecopages/core": "0.2.0-rc.5",
     "@ecopages/jsx": "^0.3.0-rc.2",
     "@ecopages/radiant": "^0.3.0-rc.2"
   }
-}
+}

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

@@ -13,7 +13,12 @@ export type EcopagesJsxMdxPageModule = EcoPageFile<{
 }>;
 export { appendMdxExtensions, createMdxExtensionFilter };
 export declare const resolveMdxCompilerOptions: (mdxOptions: EcopagesJsxMdxOptions) => ResolvedMdxCompileOptions;
-export declare const createMdxLoaderPlugin: (compilerOptions: ResolvedMdxCompileOptions, extensions: string[]) => EcoBuildPlugin;
-export declare const registerBunMdxPlugin: (compilerOptions: ResolvedMdxCompileOptions, extensions: string[]) => Promise<void>;
+export interface CreateEcopagesJsxMdxLoaderPluginOptions {
+    compilerOptions: ResolvedMdxCompileOptions;
+    extensions: string[];
+    projectRoot: string;
+}
+export declare const createMdxLoaderPlugin: (options: CreateEcopagesJsxMdxLoaderPluginOptions) => EcoBuildPlugin;
+export declare const registerBunMdxPlugin: (options: CreateEcopagesJsxMdxLoaderPluginOptions) => Promise<void>;
 export declare const isMdxFile: (filePath: string, extensions: string[]) => boolean;
 export declare const normalizeMdxPageModule: (file: string, module: EcopagesJsxMdxPageModule) => EcopagesJsxMdxPageModule;

package/src/ecopages-jsx-mdx.js

@@ -1,8 +1,5 @@
-import { readFile } from 'node:fs/promises';
 import { ensurePageConfigLayouts } from '@ecopages/core/eco/page-layout-normalization';
-import { rapidhash } from '@ecopages/core/hash';
 import { appendMdxExtensions, createMdxExtensionFilter, createMdxLoaderPlugin as createMdxLoaderPluginCore, resolveMdxCompilerOptions as resolveMdxCompilerOptionsCore, } from '@ecopages/mdx/core';
-import { VFile } from 'vfile';
 import { ECOPAGES_JSX_PLUGIN_NAME } from './ecopages-jsx.constants.js';
 export { appendMdxExtensions, createMdxExtensionFilter };
 export const resolveMdxCompilerOptions = (mdxOptions) => resolveMdxCompilerOptionsCore(mdxOptions, {
@@ -12,27 +9,24 @@ export const resolveMdxCompilerOptions = (mdxOptions) => resolveMdxCompilerOptio
         outputFormat: 'program',
     },
 });
-export const createMdxLoaderPlugin = (compilerOptions, extensions) => createMdxLoaderPluginCore({
+export const createMdxLoaderPlugin = (options) => createMdxLoaderPluginCore({
     name: 'ecopages-jsx-mdx-loader',
-    compilerOptions,
-    extensions,
+    integrationName: ECOPAGES_JSX_PLUGIN_NAME,
+    compilerOptions: options.compilerOptions,
+    extensions: options.extensions,
     includeSourceMap: false,
     loader: 'js',
+    projectRoot: options.projectRoot,
 });
-export const registerBunMdxPlugin = async (compilerOptions, extensions) => {
+export const registerBunMdxPlugin = async (options) => {
     if (typeof Bun === 'undefined') {
         return;
     }
-    const filter = createMdxExtensionFilter(extensions);
+    const plugin = createMdxLoaderPlugin(options);
     Bun.plugin({
-        name: 'ecopages-jsx-mdx',
+        name: plugin.name,
         setup(build) {
-            build.onLoad({ filter }, async (args) => {
-                const { compile } = await import('@mdx-js/mdx');
-                const source = await readFile(args.path, 'utf-8');
-                const compiled = await compile(new VFile({ value: source, path: args.path }), compilerOptions);
-                return { contents: String(compiled.value), loader: 'js' };
-            });
+            return plugin.setup(build);
         },
     });
 };
@@ -44,27 +38,22 @@ export const normalizeMdxPageModule = (file, module) => {
         throw new TypeError('MDX file must export a callable default component.');
     }
     const Page = module.default;
-    const normalizedConfig = {
-        ...(module.config ?? Page.config ?? {}),
-        identity: module.config?.identity ??
-            Page.config?.identity ?? {
-            id: String(rapidhash(file)),
-            file,
-            integration: ECOPAGES_JSX_PLUGIN_NAME,
-        },
-    };
-    if (module.layout && !(normalizedConfig.layouts && normalizedConfig.layouts.length > 0)) {
-        normalizedConfig.layout = module.layout;
+    const attributedConfig = module.config ?? Page.config;
+    if (!attributedConfig?.identity) {
+        throw new Error(`[ecopages] MDX page "${file}" is missing component identity; the MDX loader must attribute it.`);
+    }
+    if (module.layout && !(attributedConfig.layouts && attributedConfig.layouts.length > 0)) {
+        attributedConfig.layout = module.layout;
     }
-    ensurePageConfigLayouts(normalizedConfig);
+    ensurePageConfigLayouts(attributedConfig);
     const wrappedPage = async (props) => await Page(props);
-    wrappedPage.config = normalizedConfig;
+    wrappedPage.config = attributedConfig;
     if (module.getMetadata ?? Page.metadata) {
         wrappedPage.metadata = module.getMetadata ?? Page.metadata;
     }
     return {
         ...module,
         default: wrappedPage,
-        config: normalizedConfig,
+        config: attributedConfig,
     };
 };

package/src/ecopages-jsx.plugin.js

@@ -150,7 +150,14 @@ export class EcopagesJsxPlugin extends IntegrationPlugin {
         if (!this.mdxEnabled || !this.mdxCompilerOptions || this.mdxLoaderPlugin) {
             return;
         }
-        this.mdxLoaderPlugin = createMdxLoaderPlugin(this.mdxCompilerOptions, this.mdxExtensions);
+        if (!this.appConfig?.rootDir) {
+            throw new Error('[EcopagesJsxPlugin] Cannot create MDX loader: appConfig.rootDir is required.');
+        }
+        this.mdxLoaderPlugin = createMdxLoaderPlugin({
+            compilerOptions: this.mdxCompilerOptions,
+            extensions: this.mdxExtensions,
+            projectRoot: this.appConfig.rootDir,
+        });
     }
     /**
      * Registers Bun's MDX loader at runtime setup time.
@@ -162,7 +169,14 @@ export class EcopagesJsxPlugin extends IntegrationPlugin {
         if (typeof Bun === 'undefined' || !this.mdxCompilerOptions) {
             return;
         }
-        await registerBunMdxPlugin(this.mdxCompilerOptions, this.mdxExtensions);
+        if (!this.appConfig) {
+            throw new Error('[EcopagesJsxPlugin] Cannot register Bun MDX plugin: appConfig is not set');
+        }
+        await registerBunMdxPlugin({
+            compilerOptions: this.mdxCompilerOptions,
+            extensions: this.mdxExtensions,
+            projectRoot: this.appConfig.rootDir,
+        });
     }
 }
 /**