@modern-js/runtime 3.0.0-alpha.0 → 3.0.0-alpha.2

package/dist/esm-node/core/react/wrapper.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { jsx } from "react/jsx-runtime";
 import { InternalRuntimeContext, RuntimeContext } from "../context/index.mjs";
 function wrapRuntimeContextProvider(App, contextValue) {

package/dist/esm-node/core/server/constants.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 const HTML_PLACEHOLDER = '<!--<?- html ?>-->';
 const SSR_DATA_PLACEHOLDER = '<!--<?- SSRDataScript ?>-->';
 const CHUNK_JS_PLACEHOLDER = '<!--<?- chunksMap.js ?>-->';

package/dist/esm-node/core/server/helmet.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { EOL } from "os";
 import { safeReplace } from "./utils.mjs";
 const RE_HTML_ATTR = /<html[^>]*>/;

package/dist/esm-node/core/server/index.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { NoSSR, NoSSRCache } from "./react/index.mjs";
 const ssr = (_config)=>({
         name: '@modern-js/plugin-ssr',

package/dist/esm-node/core/server/react/index.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { NoSSR } from "./nossr/index.mjs";
 import { NoSSRCache } from "./no-ssr-cache/index.mjs";
 export { NoSSR, NoSSRCache };

package/dist/esm-node/core/server/react/no-ssr-cache/index.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { jsx } from "react/jsx-runtime";
 import "react";
 import { Helmet } from "../../../../exports/head.mjs";

package/dist/esm-node/core/server/react/nossr/index.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import react, { useEffect, useState } from "react";
 const NoSSR = (props)=>{
     const [isMounted, setMounted] = useState(false);

package/dist/esm-node/core/server/requestHandler.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { jsx } from "react/jsx-runtime";
 import { storage } from "@modern-js/runtime-utils/node";
 import { getPathname, parseCookie, parseHeaders, parseQuery } from "@modern-js/runtime-utils/universal/request";

package/dist/esm-node/core/server/server.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { renderString } from "./string/index.mjs";
 import { renderStreaming } from "./stream/index.mjs";
 import { createRequestHandler } from "./requestHandler.mjs";

package/dist/esm-node/core/server/shared.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 function buildHtml(template, callbacks) {
     return callbacks.reduce((promise, buildHtmlCb)=>promise.then((template)=>buildHtmlCb(template)), Promise.resolve(template));
 }

package/dist/esm-node/core/server/stream/afterTemplate.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { serializeJson } from "@modern-js/runtime-utils/node";
 import { SSR_DATA_JSON_ID } from "../../constants.mjs";
 import { SSR_DATA_PLACEHOLDER } from "../constants.mjs";

package/dist/esm-node/core/server/stream/beforeTemplate.mjs

@@ -1,13 +1,18 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
+import { fileURLToPath as __rspack_fileURLToPath } from "node:url";
+import { dirname as __rspack_dirname } from "node:path";
 import { matchRoutes } from "@modern-js/runtime-utils/router";
 import react_helmet from "react-helmet";
 import { CHUNK_CSS_PLACEHOLDER } from "../constants.mjs";
 import { createReplaceHelemt } from "../helmet.mjs";
 import { buildHtml } from "../shared.mjs";
 import { checkIsNode, safeReplace } from "../utils.mjs";
+var beforeTemplate_dirname = __rspack_dirname(__rspack_fileURLToPath(import.meta.url));
 const readAsset = async (chunk)=>{
     const fs = await import("fs/promises");
     const path = await import("path");
-    const filepath = path.join(__dirname, chunk);
+    const filepath = path.join(beforeTemplate_dirname, chunk);
     return fs.readFile(filepath, 'utf-8');
 };
 const checkIsInline = (chunk, enableInline)=>{

package/dist/esm-node/core/server/stream/createReadableStream.mjs

@@ -1,12 +1,13 @@
-import { PassThrough, Transform } from "stream";
-import { createReadableStreamFromReadable, storage } from "@modern-js/runtime-utils/node";
-import isbot_0 from "isbot";
+import "node:module";
+/*#__PURE__*/ import.meta.url;
+import { PassThrough, Readable, Transform } from "stream";
+import { storage } from "@modern-js/runtime-utils/node";
 import { ESCAPED_SHELL_STREAM_END_MARK } from "../../../common.mjs";
 import { RenderLevel } from "../../constants.mjs";
 import { getGlobalInternalRuntimeContext } from "../../context/index.mjs";
 import { getMonitors } from "../../context/monitors/index.mjs";
 import { enqueueFromEntries } from "./deferredScript.mjs";
-import { ShellChunkStatus, getReadableStreamFromString } from "./shared.mjs";
+import { ShellChunkStatus, getReadableStreamFromString, resolveStreamingMode } from "./shared.mjs";
 import { getTemplates } from "./template.mjs";
 const defaultExtender = {
     modifyRootElement: (rootElement)=>rootElement,
@@ -19,9 +20,7 @@ const createReadableStreamFromElement = async (request, rootElement, options)=>{
     let shellChunkStatus = ShellChunkStatus.START;
     let renderLevel = RenderLevel.SERVER_RENDER;
     const forceStream2String = Boolean(process.env.MODERN_JS_STREAM_TO_STRING);
-    const isbot = isbot_0(request.headers.get('user-agent'));
-    const isSsgRender = 'true' === request.headers.get('x-modern-ssg-render');
-    const onReady = isbot || isSsgRender || forceStream2String ? 'onAllReady' : 'onShellReady';
+    const { onReady } = resolveStreamingMode(request, forceStream2String);
     const internalRuntimeContext = getGlobalInternalRuntimeContext();
     const hooks = internalRuntimeContext.hooks;
     const extenders = hooks.extendStreamSSR.call() || [];
@@ -77,7 +76,7 @@ const createReadableStreamFromElement = async (request, rootElement, options)=>{
                         }
                     });
                     const passThrough = new PassThrough();
-                    const stream = createReadableStreamFromReadable(body);
+                    const stream = Readable.toWeb(body);
                     resolve(stream);
                     let processedStream = passThrough;
                     extenders.forEach((extender)=>{

package/dist/esm-node/core/server/stream/createReadableStream.worker.mjs

@@ -1,10 +1,11 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { renderSSRStream } from "@modern-js/render/ssr";
 import { storage } from "@modern-js/runtime-utils/node";
-import isbot_0 from "isbot";
 import { ESCAPED_SHELL_STREAM_END_MARK } from "../../../common.mjs";
 import { RenderLevel } from "../../constants.mjs";
 import { enqueueFromEntries } from "./deferredScript.mjs";
-import { ShellChunkStatus, encodeForWebStream, getReadableStreamFromString } from "./shared.mjs";
+import { ShellChunkStatus, encodeForWebStream, getReadableStreamFromString, resolveStreamingMode } from "./shared.mjs";
 import { getTemplates } from "./template.mjs";
 const createReadableStreamFromElement = async (request, rootElement, options)=>{
     let shellChunkStatus = ShellChunkStatus.START;
@@ -33,9 +34,9 @@ const createReadableStreamFromElement = async (request, rootElement, options)=>{
         readableOriginal.allReady.then(()=>{
             options?.onAllReady?.();
         });
-        const isbot = isbot_0(request.headers.get('user-agent'));
-        const isSsgRender = 'true' === request.headers.get('x-modern-ssg-render');
-        if (isbot || isSsgRender) await readableOriginal.allReady;
+        const forceStreamToString = Boolean("u" > typeof process && process.env?.MODERN_JS_STREAM_TO_STRING);
+        const { waitForAllReady } = resolveStreamingMode(request, forceStreamToString);
+        if (waitForAllReady) await readableOriginal.allReady;
         const reader = readableOriginal.getReader();
         const stream = new ReadableStream({
             start (controller) {

package/dist/esm-node/core/server/stream/deferredScript.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { runRouterDataFnStr } from "../../../router/runtime/constants.mjs";
 const HTML_ESCAPE_MAP = {
     '&': '&',

package/dist/esm-node/core/server/stream/index.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { createRenderStreaming } from "./shared.mjs";
 const createReadableStreamFromElement = 'edge' === process.env.MODERN_SSR_ENV ? import("./createReadableStream.worker.mjs").then((m)=>m.createReadableStreamFromElement) : import("./createReadableStream.mjs").then((m)=>m.createReadableStreamFromElement);
 const renderStreaming = createRenderStreaming(createReadableStreamFromElement);

package/dist/esm-node/core/server/stream/shared.mjs

@@ -1,5 +1,9 @@
-import { Fragment, jsx } from "react/jsx-runtime";
+import "node:module";
+/*#__PURE__*/ import.meta.url;
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { time } from "@modern-js/runtime-utils/time";
+import isbot from "isbot";
+import { JSX_SHELL_STREAM_END_MARK } from "../../../common.mjs";
 import { wrapRuntimeContextProvider } from "../../react/wrapper.mjs";
 import { SSRErrors, SSRTimings } from "../tracer.mjs";
 import { getSSRConfigByEntry } from "../utils.mjs";
@@ -8,6 +12,38 @@ var shared_ShellChunkStatus = /*#__PURE__*/ function(ShellChunkStatus) {
     ShellChunkStatus[ShellChunkStatus["FINISH"] = 1] = "FINISH";
     return ShellChunkStatus;
 }({});
+const SHOULD_STREAM_ALL_HEADER = 'x-should-stream-all';
+function parseShouldStreamAllFlag(value) {
+    if (!value) return;
+    const normalized = value.trim().toLowerCase();
+    if ('false' === normalized) return false;
+    return true;
+}
+function resolveStreamingMode(request, forceStreamToString) {
+    const shouldStreamAll = parseShouldStreamAllFlag(request.headers.get(SHOULD_STREAM_ALL_HEADER));
+    const isSsgRender = 'true' === request.headers.get('x-modern-ssg-render');
+    const isBot = isbot(request.headers.get('user-agent'));
+    if (shouldStreamAll) return {
+        onReady: 'onAllReady',
+        waitForAllReady: true
+    };
+    if (forceStreamToString) return {
+        onReady: 'onAllReady',
+        waitForAllReady: true
+    };
+    if (isBot) return {
+        onReady: 'onAllReady',
+        waitForAllReady: true
+    };
+    if (isSsgRender) return {
+        onReady: 'onAllReady',
+        waitForAllReady: true
+    };
+    return {
+        onReady: 'onShellReady',
+        waitForAllReady: false
+    };
+}
 let encoder;
 function encodeForWebStream(thing) {
     if (!encoder) encoder = new TextEncoder();
@@ -31,13 +67,16 @@ function createRenderStreaming(createReadableStreamPromise) {
         const { onError, onTiming } = options;
         const { htmlTemplate, entryName } = resource;
         const ssrConfig = getSSRConfigByEntry(entryName, config.ssr, config.ssrByEntries);
-        const RSCServerRoot = ({ children })=>/*#__PURE__*/ jsx(Fragment, {
-                children: children
+        const StreamServerRootWrapper = ({ children })=>/*#__PURE__*/ jsxs(Fragment, {
+                children: [
+                    children,
+                    JSX_SHELL_STREAM_END_MARK
+                ]
             });
         let rootElement = wrapRuntimeContextProvider(serverRoot, Object.assign(runtimeContext, {
             ssr: true
         }));
-        rootElement = /*#__PURE__*/ jsx(RSCServerRoot, {
+        rootElement = /*#__PURE__*/ jsx(StreamServerRootWrapper, {
             children: rootElement
         });
         const stream = await createReadableStreamFromElement(request, rootElement, {
@@ -68,4 +107,4 @@ function createRenderStreaming(createReadableStreamPromise) {
         return stream;
     };
 }
-export { shared_ShellChunkStatus as ShellChunkStatus, createRenderStreaming, encodeForWebStream, getReadableStreamFromString };
+export { shared_ShellChunkStatus as ShellChunkStatus, createRenderStreaming, encodeForWebStream, getReadableStreamFromString, resolveStreamingMode };

package/dist/esm-node/core/server/stream/template.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { buildShellAfterTemplate } from "./afterTemplate.mjs";
 import { buildShellBeforeTemplate } from "./beforeTemplate.mjs";
 const HTML_SEPARATOR = '<!--<?- html ?>-->';

package/dist/esm-node/core/server/string/index.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { time } from "@modern-js/runtime-utils/time";
 import server from "react-dom/server";
 import react_helmet from "react-helmet";

package/dist/esm-node/core/server/string/loadable.mjs

@@ -1,5 +1,10 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
+import { fileURLToPath as __rspack_fileURLToPath } from "node:url";
+import { dirname as __rspack_dirname } from "node:path";
 import { ChunkExtractor } from "@loadable/server";
 import { attributesToString, checkIsNode } from "../utils.mjs";
+var loadable_dirname = __rspack_dirname(__rspack_fileURLToPath(import.meta.url));
 const extname = (uri)=>{
     if ('string' != typeof uri || !uri.includes('.')) return '';
     return `.${uri?.split('.').pop()}` || '';
@@ -13,7 +18,7 @@ const checkIsInline = (chunk, enableInline)=>{
 const readAsset = async (chunk)=>{
     const fs = await import("fs/promises");
     const path = await import("path");
-    const filepath = path.resolve(__dirname, chunk.filename);
+    const filepath = path.resolve(loadable_dirname, chunk.filename);
     return fs.readFile(filepath, 'utf-8');
 };
 class LoadableCollector {

package/dist/esm-node/core/server/string/ssrData.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { serializeJson } from "@modern-js/runtime-utils/node";
 import { ROUTER_DATA_JSON_ID, SSR_DATA_JSON_ID } from "../../constants.mjs";
 import { attributesToString, serializeErrors } from "../utils.mjs";

package/dist/esm-node/core/server/string/types.mjs

@@ -0,0 +1,2 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;

package/dist/esm-node/core/server/tracer.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 var tracer_SSRTimings = /*#__PURE__*/ function(SSRTimings) {
     SSRTimings["PRERENDER"] = "ssr-prerender";
     SSRTimings["RENDER_HTML"] = "ssr-render-html";

package/dist/esm-node/core/server/utils.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { isRouteErrorResponse } from "@modern-js/runtime-utils/router";
 function attributesToString(attributes) {
     return Object.entries(attributes).reduce((str, [key, value])=>void 0 === value ? str : `${str} ${key}="${value}"`, '');

package/dist/esm-node/core/types.mjs

@@ -0,0 +1,2 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;

package/dist/esm-node/document/Body.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useContext } from "react";
 import { DocumentStructureContext } from "./DocumentStructureContext.mjs";

package/dist/esm-node/document/Comment.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { Fragment, jsxs } from "react/jsx-runtime";
 import "react";
 import { DOCUMENT_COMMENT_PLACEHOLDER_END, DOCUMENT_COMMENT_PLACEHOLDER_START } from "./constants.mjs";

package/dist/esm-node/document/DocumentContext.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import react from "react";
 const DocumentContext = /*#__PURE__*/ react.createContext({
     config: {},

package/dist/esm-node/document/DocumentStructureContext.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import react from "react";
 const DocumentStructureContext = /*#__PURE__*/ react.createContext({
     hasSetHead: false,

package/dist/esm-node/document/Head.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useContext } from "react";
 import { DocumentStructureContext } from "./DocumentStructureContext.mjs";

package/dist/esm-node/document/Html.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { jsx, jsxs } from "react/jsx-runtime";
 import "react";
 import { Body } from "./Body.mjs";

package/dist/esm-node/document/Links.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { Fragment, jsx } from "react/jsx-runtime";
 import "react";
 import { DOCUMENT_LINKS_PLACEHOLDER } from "./constants.mjs";

package/dist/esm-node/document/Root.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { jsxs } from "react/jsx-runtime";
 import { omit } from "@modern-js/utils/lodash";
 import { useContext } from "react";

package/dist/esm-node/document/Script.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { renderToString } from "react-dom/server";
 import { DOCUMENT_SCRIPT_ATTRIBUTES_END, DOCUMENT_SCRIPT_ATTRIBUTES_START, DOCUMENT_SCRIPT_PLACEHOLDER_END, DOCUMENT_SCRIPT_PLACEHOLDER_START } from "./constants.mjs";

package/dist/esm-node/document/Scripts.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { Fragment, jsx } from "react/jsx-runtime";
 import "react";
 import { DOCUMENT_SCRIPTS_PLACEHOLDER } from "./constants.mjs";

package/dist/esm-node/document/Style.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { Fragment, jsxs } from "react/jsx-runtime";
 import "react";
 import { DOCUMENT_STYLE_PLACEHOLDER_END, DOCUMENT_STYLE_PLACEHOLDER_START } from "./constants.mjs";

package/dist/esm-node/document/Title.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { jsx } from "react/jsx-runtime";
 import { DOCUMENT_TITLE_PLACEHOLDER } from "./constants.mjs";
 function Title() {

package/dist/esm-node/document/cli/index.mjs

@@ -1,6 +1,8 @@
+import __rslib_shim_module__ from "node:module";
+const require = /*#__PURE__*/ __rslib_shim_module__.createRequire(import.meta.url);
 import module_0, { builtinModules } from "module";
 import path from "path";
-import { createDebugger, findExists, fs } from "@modern-js/utils";
+import { createDebugger, findExists, fs, logger } from "@modern-js/utils";
 import { decodeHTML } from "entities";
 import { BODY_PARTICALS_SEPARATOR, DOCUMENT_CHUNKSMAP_PLACEHOLDER, DOCUMENT_COMMENT_PLACEHOLDER_END, DOCUMENT_COMMENT_PLACEHOLDER_START, DOCUMENT_FILE_NAME, DOCUMENT_LINKS_PLACEHOLDER, DOCUMENT_META_PLACEHOLDER, DOCUMENT_SCRIPTS_PLACEHOLDER, DOCUMENT_SCRIPT_ATTRIBUTES_END, DOCUMENT_SCRIPT_ATTRIBUTES_START, DOCUMENT_SCRIPT_PLACEHOLDER_END, DOCUMENT_SCRIPT_PLACEHOLDER_START, DOCUMENT_SSRDATASCRIPT_PLACEHOLDER, DOCUMENT_SSR_PLACEHOLDER, DOCUMENT_STYLE_PLACEHOLDER_END, DOCUMENT_STYLE_PLACEHOLDER_START, DOCUMENT_TITLE_PLACEHOLDER, DOC_EXT, HEAD_PARTICALS_SEPARATOR, HTML_SEPARATOR, PLACEHOLDER_REPLACER_MAP, TOP_PARTICALS_SEPARATOR } from "../constants.mjs";
 const debug = createDebugger('document');
@@ -96,12 +98,13 @@ const applyExternalsPlugin = (child, compiler)=>{
         EXTERNAL_MAPPINGS
     ]).apply(child);
 };
-const generateEntryCode = (docPath, _entryName)=>`var React = require('react');
-var ReactDomServer = require('react-dom/server');
-var exp = require(${JSON.stringify(docPath)});
-var DocumentContext = require('@meta/runtime/document').DocumentContext;
-
-var Document = exp && exp.default;
+const generateEntryCode = (docPath, _entryName)=>{
+    const runtimeAPI = require.resolve('../');
+    const esmRuntimeAPI = runtimeAPI.replace("cjs", "esm").replace(/.js$/, '.mjs');
+    return `import React from 'react';
+import ReactDomServer from 'react-dom/server';
+import Document from ${JSON.stringify(docPath)};
+import { DocumentContext } from ${JSON.stringify(esmRuntimeAPI)};
 
 // expose to global for host to consume
 var g = (typeof globalThis !== 'undefined' ? globalThis : global);
@@ -118,7 +121,8 @@ function render(documentParams) {
 
 g.__MODERN_DOC_RENDERERS__[${JSON.stringify(_entryName)}] = render;
 
-module.exports = { render: render };`;
+export default { render: render };`;
+};
 const processChildCompilation = async (entryName, docPath, compilation, compiler, appDirectory, internalDirectory)=>new Promise((resolve, reject)=>{
         const outFile = path.posix.join(CONSTANTS.DOCUMENT_OUTPUT_DIR, `${CONSTANTS.HTML_OUTPUT_PREFIX}${entryName}${CONSTANTS.HTML_OUTPUT_SUFFIX}`);
         const child = compilation.createChildCompiler(`${CONSTANTS.CHILD_COMPILER_PREFIX}${entryName}`, {
@@ -139,31 +143,48 @@ const processChildCompilation = async (entryName, docPath, compilation, compiler
                     name: `${CONSTANTS.CHILD_COMPILER_PREFIX}${entryName}`
                 }).apply(child);
                 child.runAsChild((err, _entries, childCompilation)=>{
-                    if (err) return reject(err);
+                    if (err) {
+                        logger.error(`Document child compiler failed for entry "${entryName}": ${err.message}`);
+                        return reject(err);
+                    }
                     try {
                         if (!childCompilation) throw new Error('Child compilation is undefined');
                         const asset = childCompilation.assets[outFile] || childCompilation.getAsset?.(outFile)?.source;
                         const code = 'function' == typeof asset?.source ? asset.source().toString() : 'string' == typeof asset ? asset : asset?.buffer?.().toString?.() || '';
-                        if (code) {
-                            entryName2DocCode.set(entryName, code);
-                            debug('Document child compiler: cached injected bundle for %s', entryName);
-                        } else debug('Document child compiler: empty asset for %s', entryName);
+                        if (!code) {
+                            const errorMsg = `Document child compiler produced empty output for entry "${entryName}". Please check your Document component for syntax errors.`;
+                            logger.error(errorMsg);
+                            reject(new Error(errorMsg));
+                            return;
+                        }
+                        entryName2DocCode.set(entryName, code);
+                        debug('Document child compiler: cached injected bundle for %s', entryName);
                         resolve();
                     } catch (e) {
-                        reject(e);
+                        const err = e;
+                        logger.error(`Document child compiler failed to process output for entry "${entryName}": ${err.message}`);
+                        reject(err);
                     }
                 });
             } catch (e) {
-                reject(e);
+                const err = e;
+                logger.error(`Document child compiler failed to initialize for entry "${entryName}": ${err.message}`);
+                reject(err);
             }
         };
         try {
             fs.ensureFile(tempEntry).then(()=>{
                 const entryCode = generateEntryCode(docPath, entryName);
                 return fs.writeFile(tempEntry, entryCode);
-            }).then(finalize).catch((e)=>reject(e));
+            }).then(finalize).catch((e)=>{
+                const err = e;
+                logger.error(`Document child compiler failed to prepare entry file for "${entryName}": ${err.message}`);
+                reject(err);
+            });
         } catch (e) {
-            reject(e);
+            const err = e;
+            logger.error(`Document child compiler failed to create entry directory for "${entryName}": ${err.message}`);
+            reject(err);
         }
     });
 const documentPlugin = ()=>({
@@ -189,7 +210,10 @@ const documentPlugin = ()=>({
                             }
                             await Promise.all(tasks);
                         } catch (e) {
+                            const err = e;
+                            logger.error(`Document child compiler failed: ${err.message}`);
                             debug('Document child compiler make hook failed: %o', e);
+                            throw err;
                         }
                     });
                 }
@@ -197,21 +221,13 @@ const documentPlugin = ()=>({
                     this.name = 'ModernJsDocumentChildCompilerPlugin';
                 }
             }
-            api.config(()=>{
-                const documentPath = require.resolve('../');
-                return {
-                    resolve: {
-                        alias: {
-                            '@meta/runtime/document$': documentPath.replace(`${path.sep}cjs${path.sep}`, `${path.sep}esm${path.sep}`).replace(/.js$/, '.mjs')
-                        }
-                    },
+            api.config(()=>({
                     tools: {
                         bundlerChain: (chain)=>{
                             chain.plugin('modernjs-document-child-compiler').use(ModernJsDocumentChildCompilerPlugin, []);
                         }
                     }
-                };
-            });
+                }));
             const getDocParams = (params)=>{
                 const { config, templateParameters, entryName } = params;
                 return {
@@ -230,11 +246,13 @@ const documentPlugin = ()=>({
                     renderer: globalRenderer
                 };
                 const cached = entryName2DocCode.get(entryName);
-                if (!cached) throw new Error(`Failed to load Document bundle for entry "${entryName}". This is likely because the Document component compilation failed or the bundle was not generated correctly. Please check your Document component implementation.`);
+                if (!cached) throw new Error(`Document bundle not found for entry "${entryName}". The Document component compilation may have failed.`);
                 const filename = path.join(internalDirectory, `./${CONSTANTS.DOCUMENT_OUTPUT_DIR}/${CONSTANTS.HTML_OUTPUT_PREFIX}${entryName}${CONSTANTS.HTML_OUTPUT_SUFFIX}`);
                 requireFromString(cached, filename);
+                const renderer = renderers[entryName];
+                if (!renderer) throw new Error(`Document renderer not found for entry "${entryName}". Please ensure your Document component exports a valid default component.`);
                 return {
-                    renderer: renderers[entryName]
+                    renderer
                 };
             };
             const processPartials = (html, entryName, partialsByEntrypoint)=>{
@@ -250,17 +268,17 @@ const documentPlugin = ()=>({
                 }
                 return html.replace(TOP_PARTICALS_SEPARATOR, ()=>partialsContent.partialsTop).replace(HEAD_PARTICALS_SEPARATOR, ()=>partialsContent.partialsHead).replace(BODY_PARTICALS_SEPARATOR, ()=>partialsContent.partialsBody);
             };
-            const extractHtmlTags = (htmlWebpackPlugin, templateParameters)=>{
+            const extractHtmlTags = (htmlPlugin, templateParameters)=>{
                 const scripts = [
-                    htmlWebpackPlugin.tags.headTags.filter((item)=>"script" === item.tagName).join(''),
-                    htmlWebpackPlugin.tags.bodyTags.toString()
+                    htmlPlugin.tags.headTags.filter((item)=>"script" === item.tagName).join(''),
+                    htmlPlugin.tags.bodyTags.toString()
                 ].join('');
-                const links = htmlWebpackPlugin.tags.headTags.filter((item)=>'link' === item.tagName).join('');
+                const links = htmlPlugin.tags.headTags.filter((item)=>'link' === item.tagName).join('');
                 const metas = [
                     templateParameters.meta,
-                    htmlWebpackPlugin.tags.headTags.filter((item)=>"script" !== item.tagName && 'link' !== item.tagName && 'title' !== item.tagName).join('')
+                    htmlPlugin.tags.headTags.filter((item)=>"script" !== item.tagName && 'link' !== item.tagName && 'title' !== item.tagName).join('')
                 ].join('');
-                const titles = htmlWebpackPlugin.tags.headTags.filter((item)=>'title' === item.tagName).join('').replace('<title>', '').replace('</title>', '');
+                const titles = htmlPlugin.tags.headTags.filter((item)=>'title' === item.tagName).join('').replace('<title>', '').replace('</title>', '');
                 return {
                     scripts,
                     links,
@@ -279,19 +297,26 @@ const documentPlugin = ()=>({
                 const { entrypoints, internalDirectory, appDirectory } = api.getAppContext();
                 const documentFilePath = getDocumentByEntryName(entrypoints, entryName, appDirectory);
                 if (!documentFilePath) return null;
-                return async ({ htmlWebpackPlugin })=>{
+                return async ({ htmlPlugin })=>{
                     const config = api.getNormalizedConfig();
                     const documentParams = getDocParams({
                         config: config,
                         entryName,
                         templateParameters
                     });
-                    const { renderer } = await loadRender(entryName, internalDirectory);
-                    let html = renderer?.(documentParams);
+                    let html;
+                    try {
+                        const { renderer } = await loadRender(entryName, internalDirectory);
+                        html = renderer(documentParams);
+                    } catch (error) {
+                        const err = error;
+                        logger.error(`Failed to render Document for entry "${entryName}": ${err.message}`);
+                        throw err;
+                    }
                     debug("entry %s's document jsx rendered html: %o", entryName, html);
                     const { partialsByEntrypoint } = api.getAppContext();
                     html = processPartials(html, entryName, partialsByEntrypoint || {});
-                    const { scripts, links, metas, titles } = extractHtmlTags(htmlWebpackPlugin, templateParameters);
+                    const { scripts, links, metas, titles } = extractHtmlTags(htmlPlugin, templateParameters);
                     return processPlaceholders(html, config, scripts, links, metas, titles);
                 };
             };

package/dist/esm-node/document/constants.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 import { HTML_CHUNKSMAP_SEPARATOR } from "@modern-js/utils/universal/constants";
 const DOC_EXT = [
     'jsx',

package/dist/esm-node/document/index.mjs

@@ -1,3 +1,5 @@
+import "node:module";
+/*#__PURE__*/ import.meta.url;
 export * from "./Html.mjs";
 export * from "./DocumentContext.mjs";
 export * from "./DocumentStructureContext.mjs";