@ecopages/ecopages-jsx 0.2.0-rc.11 → 0.2.0-rc.14

package/package.json

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

package/src/ecopages-jsx-hmr-ownership.d.ts

@@ -1,16 +1,20 @@
 /**
- * Tracks the source files that participate in the active SSR render tree.
+ * Tracks the source files that produced the most recent JSX render.
  *
  * @remarks
- * The JSX integration renderer calls {@link updateEjsxHmrOwnership} after each
- * page, component, or view render so the HMR strategy can answer
- * "does this changed file affect SSR HTML?" without re-walking the tree on
- * every watcher event.
+ * The JSX renderer runs each page, component, or view render inside
+ * {@link withEjsxHmrOwnershipScope} and records its components with
+ * {@link recordEjsxHmrOwnership}. `EcopagesJsxHmrStrategy` reads the result to
+ * decide whether a changed file affects SSR HTML without walking the component
+ * tree on every watcher event.
  *
- * The state is module-scoped because the HMR strategy and renderer live in
- * different call sites (server strategy vs SSR renderer) and share no other
- * lifecycle anchor. A fresh state is installed only when the source-file set
- * changes, so the renderer's per-render hook stays O(1) in the steady state.
+ * The state is module-scoped because the renderer and the HMR strategy share no
+ * other lifecycle anchor. Publishing replaces it only when the file set changes,
+ * so repeated renders of the same page keep the existing state.
+ *
+ * Only the latest top-level render is kept. With several pages open, a file
+ * used only by a page that rendered earlier is not matched until that page
+ * renders again.
  */
 import type { EcoComponent } from '@ecopages/core';
 export type EjsxHmrOwnershipState = {
@@ -32,13 +36,21 @@ export declare function getEjsxHmrOwnership(): EjsxHmrOwnershipState;
  */
 export declare function updateEjsxHmrOwnership(components: ReadonlyArray<EcoComponent | Partial<EcoComponent> | undefined>): void;
 /**
- * Merges one render tree into a pending ownership set during an active render.
+ * Runs one render and publishes the files it recorded once the outermost scope ends.
+ *
+ * @remarks
+ * Nested renders, such as components and foreign subtrees resolved inside a
+ * page, join the outer scope, so the published set covers the whole render tree
+ * instead of the last nested render.
  */
-export declare function mergeEjsxHmrOwnership(target: Set<string>, components: ReadonlyArray<EcoComponent | undefined>): void;
+export declare function withEjsxHmrOwnershipScope<T>(render: () => T | Promise<T>): Promise<T>;
 /**
- * Publishes the merged ownership set for the completed render.
+ * Adds the source files of `components`, their declared dependencies and their
+ * layouts to the active render scope.
+ *
+ * @throws Error when called outside {@link withEjsxHmrOwnershipScope}.
  */
-export declare function publishEjsxHmrOwnership(files: ReadonlySet<string>): void;
+export declare function recordEjsxHmrOwnership(components: ReadonlyArray<EcoComponent | undefined>): void;
 /**
  * Resets the state to empty. Used by tests and by HMR manager teardown.
  */

package/src/ecopages-jsx-hmr-ownership.js

@@ -1,17 +1,22 @@
 /**
- * Tracks the source files that participate in the active SSR render tree.
+ * Tracks the source files that produced the most recent JSX render.
  *
  * @remarks
- * The JSX integration renderer calls {@link updateEjsxHmrOwnership} after each
- * page, component, or view render so the HMR strategy can answer
- * "does this changed file affect SSR HTML?" without re-walking the tree on
- * every watcher event.
+ * The JSX renderer runs each page, component, or view render inside
+ * {@link withEjsxHmrOwnershipScope} and records its components with
+ * {@link recordEjsxHmrOwnership}. `EcopagesJsxHmrStrategy` reads the result to
+ * decide whether a changed file affects SSR HTML without walking the component
+ * tree on every watcher event.
  *
- * The state is module-scoped because the HMR strategy and renderer live in
- * different call sites (server strategy vs SSR renderer) and share no other
- * lifecycle anchor. A fresh state is installed only when the source-file set
- * changes, so the renderer's per-render hook stays O(1) in the steady state.
+ * The state is module-scoped because the renderer and the HMR strategy share no
+ * other lifecycle anchor. Publishing replaces it only when the file set changes,
+ * so repeated renders of the same page keep the existing state.
+ *
+ * Only the latest top-level render is kept. With several pages open, a file
+ * used only by a page that rendered earlier is not matched until that page
+ * renders again.
  */
+import { AsyncLocalStorage } from 'node:async_hooks';
 import { rapidhash } from '@ecopages/core/hash';
 import { collectComponentConfigFilePaths } from '@ecopages/core/route-renderer/page-loading/file-scoped-dependency-components';
 const EMPTY_STATE = {
@@ -19,6 +24,7 @@ const EMPTY_STATE = {
     hash: '',
 };
 let currentState = EMPTY_STATE;
+const pendingFileOwners = new AsyncLocalStorage();
 /**
  * Returns the most recently recorded active render tree.
  */
@@ -38,17 +44,49 @@ export function updateEjsxHmrOwnership(components) {
     publishEjsxHmrOwnership(collectFileOwners(components));
 }
 /**
- * Merges one render tree into a pending ownership set during an active render.
+ * Runs one render and publishes the files it recorded once the outermost scope ends.
+ *
+ * @remarks
+ * Nested renders, such as components and foreign subtrees resolved inside a
+ * page, join the outer scope, so the published set covers the whole render tree
+ * instead of the last nested render.
  */
-export function mergeEjsxHmrOwnership(target, components) {
+export async function withEjsxHmrOwnershipScope(render) {
+    if (pendingFileOwners.getStore()) {
+        return await render();
+    }
+    const fileOwners = new Set();
+    try {
+        return await pendingFileOwners.run(fileOwners, render);
+    }
+    finally {
+        if (fileOwners.size > 0) {
+            publishEjsxHmrOwnership(fileOwners);
+        }
+    }
+}
+/**
+ * Adds the source files of `components`, their declared dependencies and their
+ * layouts to the active render scope.
+ *
+ * @throws Error when called outside {@link withEjsxHmrOwnershipScope}.
+ */
+export function recordEjsxHmrOwnership(components) {
+    const fileOwners = pendingFileOwners.getStore();
+    if (!fileOwners) {
+        throw new Error('Ecopages JSX HMR ownership can only be recorded inside an active render scope.');
+    }
     for (const file of collectFileOwners(components)) {
-        target.add(file);
+        fileOwners.add(file);
     }
 }
 /**
- * Publishes the merged ownership set for the completed render.
+ * Resets the state to empty. Used by tests and by HMR manager teardown.
  */
-export function publishEjsxHmrOwnership(files) {
+export function resetEjsxHmrOwnership() {
+    currentState = EMPTY_STATE;
+}
+function publishEjsxHmrOwnership(files) {
     const hash = hashFileSet(files);
     if (hash === currentState.hash) {
         return;
@@ -58,12 +96,6 @@ export function publishEjsxHmrOwnership(files) {
         hash,
     };
 }
-/**
- * Resets the state to empty. Used by tests and by HMR manager teardown.
- */
-export function resetEjsxHmrOwnership() {
-    currentState = EMPTY_STATE;
-}
 function collectFileOwners(components) {
     return collectComponentConfigFilePaths(components, { includeLayouts: true });
 }

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

@@ -14,7 +14,6 @@ export type { EcopagesJsxRendererConfig, EcopagesJsxRendererOptions } from './ec
 export declare class EcopagesJsxRenderer extends IntegrationRenderer<JsxRenderable> {
     name: string;
     private readonly mdxExtensions;
-    private readonly renderSession;
     private readonly radiantSsrPolicy;
     private readonly ssrScriptPreloader;
     /**
@@ -52,10 +51,4 @@ export declare class EcopagesJsxRenderer extends IntegrationRenderer<JsxRenderab
     private withCustomElementRenderHook;
     private withPreparedRadiantRuntime;
     private createIntrinsicCustomElementRenderHook;
-    /**
-     * Records the source files that produced the current render so
-     * {@link EcopagesJsxHmrStrategy} can match later watcher events without
-     * re-walking the component tree.
-     */
-    private recordHmrOwnership;
 }

package/src/ecopages-jsx-renderer.js

@@ -1,11 +1,10 @@
 import { IntegrationRenderer, } from '@ecopages/core/route-renderer/orchestration/integration-renderer';
 import { resolveDocumentShellLayouts } from '@ecopages/core/route-renderer/orchestration/document-shell/layout-shell-props.service';
-import { getForeignSubtreeResolutionContextKey, resolveOwningIntegrationRenderer, } from '@ecopages/core/route-renderer/orchestration/foreign-child/owning-renderer-resolution';
 import { createMarkupNodeLike } from '@ecopages/jsx';
 import { renderToString, withServerCustomElementRenderHook } from '@ecopages/jsx/server';
 import { ECOPAGES_JSX_PLUGIN_NAME } from './ecopages-jsx.constants.js';
 import { isMdxFile, normalizeMdxPageModule, } from './ecopages-jsx-mdx.js';
-import { EcopagesJsxRenderSession } from './ecopages-jsx-render-session.js';
+import { recordEjsxHmrOwnership, withEjsxHmrOwnershipScope } from './ecopages-jsx-hmr-ownership.js';
 import { EcopagesJsxRadiantSsrPolicy } from './ecopages-jsx-radiant-ssr-policy.js';
 import { CUSTOM_ELEMENT_SSR_PRELOAD_CACHE_SCOPES, CustomElementScriptPreloader, } from '@ecopages/core/route-renderer/orchestration/custom-element-scripts/custom-element-script-preloader';
 import { createSharedServerModuleImporter } from '@ecopages/core/route-renderer/orchestration/custom-element-scripts/custom-element-server-module-importer';
@@ -18,7 +17,6 @@ import { createSharedServerModuleImporter } from '@ecopages/core/route-renderer/
 export class EcopagesJsxRenderer extends IntegrationRenderer {
     name = ECOPAGES_JSX_PLUGIN_NAME;
     mdxExtensions;
-    renderSession;
     radiantSsrPolicy;
     ssrScriptPreloader;
     /**
@@ -79,19 +77,11 @@ export class EcopagesJsxRenderer extends IntegrationRenderer {
      */
     async renderQueuedForeignSubtreeChildren(children, queuedResolutionsByToken, resolveToken) {
         if (children === undefined) {
-            return { assets: [] };
+            return {};
         }
-        let html;
-        if (typeof children === 'string') {
-            html = children;
-        }
-        else {
-            html = await this.renderJsx(children);
-        }
-        html = await this.foreignSubtreeExecutionService.resolveQueuedTokens(html, queuedResolutionsByToken, resolveToken);
+        const html = typeof children === 'string' ? children : await this.renderJsx(children);
         return {
-            assets: [],
-            html,
+            html: await this.foreignSubtreeExecutionService.resolveQueuedTokens(html, queuedResolutionsByToken, resolveToken),
         };
     }
     createForeignChildRuntime(options) {
@@ -121,7 +111,6 @@ export class EcopagesJsxRenderer extends IntegrationRenderer {
             runtimeOrigin,
         });
         this.mdxExtensions = jsxConfig?.mdxExtensions ?? ['.mdx'];
-        this.renderSession = new EcopagesJsxRenderSession();
         const radiantSsrEnabled = jsxConfig?.radiantSsrEnabled ?? false;
         this.radiantSsrPolicy = jsxConfig?.radiantSsrPolicy ?? new EcopagesJsxRadiantSsrPolicy(radiantSsrEnabled);
         const preferSourceImports = typeof Bun !== 'undefined';
@@ -161,7 +150,7 @@ export class EcopagesJsxRenderer extends IntegrationRenderer {
                 options.HtmlTemplate,
                 ...(options.resolvedPageDependencyComponents ?? []),
             ]);
-            return await this.renderSession.withActiveScope(async () => {
+            return await withEjsxHmrOwnershipScope(async () => {
                 try {
                     const result = await this.renderPageWithDocumentShell({
                         page: {
@@ -188,7 +177,7 @@ export class EcopagesJsxRenderer extends IntegrationRenderer {
                         metadata: options.metadata,
                         pageProps: options.pageProps ?? {},
                     });
-                    this.recordHmrOwnership([
+                    recordEjsxHmrOwnership([
                         options.Page,
                         options.Layout,
                         options.HtmlTemplate,
@@ -205,7 +194,7 @@ export class EcopagesJsxRenderer extends IntegrationRenderer {
     async renderComponent(input) {
         return await this.withPreparedRadiantRuntime(async () => {
             await this.ssrScriptPreloader.preloadSsrScripts([input.component]);
-            return await this.renderSession.withActiveScope(async () => {
+            return await withEjsxHmrOwnershipScope(async () => {
                 try {
                     if (typeof input.component !== 'function') {
                         throw new TypeError('JSX renderer expected a callable component.');
@@ -221,23 +210,7 @@ export class EcopagesJsxRenderer extends IntegrationRenderer {
                         };
                     const content = await this.withCustomElementRenderHook(() => component(componentProps));
                     const html = await this.renderJsx(content);
-                    const queuedForeignSubtreeResolution = await this.foreignSubtreeExecutionService.resolveQueuedHtml({
-                        currentIntegrationName: this.name,
-                        html,
-                        runtimeContext: this.foreignSubtreeExecutionService.getQueuedRuntimeContext(input, getForeignSubtreeResolutionContextKey(this.name)),
-                        queueLabel: 'Ecopages JSX',
-                        getOwningRenderer: (integrationName, rendererCache) => resolveOwningIntegrationRenderer({
-                            appConfig: this.appConfig,
-                            runtimeOrigin: this.runtimeOrigin,
-                            currentIntegrationName: this.name,
-                            currentRenderer: this,
-                            integrationName,
-                            cache: rendererCache,
-                        }),
-                        applyAttributesToFirstElement: (resolvedHtml, attributes) => this.htmlTransformer.applyAttributesToFirstElement(resolvedHtml, attributes),
-                        dedupeProcessedAssets: (assets) => this.htmlTransformer.dedupeProcessedAssets(assets),
-                        renderQueuedChildren: (children, _runtimeContext, queuedResolutionsByToken, resolveToken) => this.renderQueuedForeignSubtreeChildren(children, queuedResolutionsByToken, resolveToken),
-                    });
+                    const queuedForeignSubtreeResolution = await this.resolveQueuedForeignSubtrees(html, this.getQueuedForeignSubtreeContext(input), (children, _runtimeContext, queuedResolutionsByToken, resolveToken) => this.renderQueuedForeignSubtreeChildren(children, queuedResolutionsByToken, resolveToken));
                     const componentAssets = input.component.config?.dependencies &&
                         typeof this.assetProcessingService?.processDependencies === 'function'
                         ? await this.processComponentDependencies([input.component])
@@ -246,7 +219,7 @@ export class EcopagesJsxRenderer extends IntegrationRenderer {
                         ...queuedForeignSubtreeResolution.assets,
                         ...componentAssets,
                     ]);
-                    this.recordHmrOwnership([input.component]);
+                    recordEjsxHmrOwnership([input.component]);
                     return this.finalizeIslandComponentRender(input, {
                         html: queuedForeignSubtreeResolution.html,
                         canAttachAttributes: true,
@@ -266,7 +239,7 @@ export class EcopagesJsxRenderer extends IntegrationRenderer {
             const viewComponent = view;
             const layouts = viewComponent.config?.layouts;
             await this.ssrScriptPreloader.preloadSsrScripts([view, ...(layouts ?? [])]);
-            return await this.renderSession.withActiveScope(async () => {
+            return await withEjsxHmrOwnershipScope(async () => {
                 try {
                     if (typeof view !== 'function') {
                         throw new TypeError('JSX renderer expected a callable view component.');
@@ -277,7 +250,7 @@ export class EcopagesJsxRenderer extends IntegrationRenderer {
                         ctx,
                         layout: layouts?.[layouts.length - 1],
                     });
-                    this.recordHmrOwnership([view]);
+                    recordEjsxHmrOwnership([view]);
                     return response;
                 }
                 catch (error) {
@@ -301,12 +274,4 @@ export class EcopagesJsxRenderer extends IntegrationRenderer {
             return instance ? this.radiantSsrPolicy.renderIntrinsicElementMarkup(instance) : undefined;
         };
     }
-    /**
-     * Records the source files that produced the current render so
-     * {@link EcopagesJsxHmrStrategy} can match later watcher events without
-     * re-walking the component tree.
-     */
-    recordHmrOwnership(components) {
-        this.renderSession.mergeHmrOwnership(components);
-    }
 }

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

@@ -10,7 +10,6 @@ export type { EcopagesJsxMdxOptions, EcopagesJsxPluginOptions, EcopagesJsxRender
 export declare class EcopagesJsxPlugin extends IntegrationPlugin<JsxRenderable> {
     renderer: typeof EcopagesJsxRenderer;
     private includeRadiant;
-    private mdxEnabled;
     private mdxCompilerOptions?;
     private mdxExtensions;
     private mdxLoaderPlugin?;

package/src/ecopages-jsx.plugin.js

@@ -30,7 +30,6 @@ const resolvePluginOptions = (options) => {
         ...baseConfig,
         extensions,
         includeRadiant: radiant ?? true,
-        mdxEnabled,
         mdxExtensions,
         mdxCompilerOptions: mdxEnabled && mdx ? resolveMdxCompilerOptions(mdx) : undefined,
     };
@@ -39,7 +38,6 @@ const resolvePluginOptions = (options) => {
 export class EcopagesJsxPlugin extends IntegrationPlugin {
     renderer = EcopagesJsxRenderer;
     includeRadiant;
-    mdxEnabled;
     mdxCompilerOptions;
     mdxExtensions;
     mdxLoaderPlugin;
@@ -59,7 +57,7 @@ export class EcopagesJsxPlugin extends IntegrationPlugin {
     }
     constructor(options) {
         const config = resolvePluginOptions(options);
-        const { extensions, includeRadiant, mdxEnabled, mdxExtensions, mdxCompilerOptions, ...baseConfig } = config;
+        const { extensions, includeRadiant, mdxExtensions, mdxCompilerOptions, ...baseConfig } = config;
         super({
             name: ECOPAGES_JSX_PLUGIN_NAME,
             extensions,
@@ -67,7 +65,6 @@ export class EcopagesJsxPlugin extends IntegrationPlugin {
             ...baseConfig,
         });
         this.includeRadiant = includeRadiant;
-        this.mdxEnabled = mdxEnabled;
         this.mdxExtensions = mdxExtensions;
         this.mdxCompilerOptions = mdxCompilerOptions;
         if (this.includeRadiant) {
@@ -148,7 +145,7 @@ export class EcopagesJsxPlugin extends IntegrationPlugin {
         await super.setup();
     }
     ensureMdxLoaderPlugin() {
-        if (!this.mdxEnabled || !this.mdxCompilerOptions || this.mdxLoaderPlugin) {
+        if (!this.mdxCompilerOptions || this.mdxLoaderPlugin) {
             return;
         }
         if (!this.appConfig?.rootDir) {

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

@@ -1,36 +0,0 @@
-import type { EcoComponent } from '@ecopages/core';
-export declare const ECOPAGES_JSX_SSR_RENDER_STATE_KEY: unique symbol;
-/**
- * Tracks JSX SSR HMR-ownership state for one active render flow.
- *
- * @remarks
- * The renderer still mirrors this state into `@ecopages/jsx/server` so nested
- * JSX renders and existing SSR-scope probes can observe it, but it also keeps
- * an internal async-local copy. That fallback avoids losing renderer state when
- * host runtimes such as Vite end up loading separate module identities for the
- * JSX server helpers.
- */
-export declare class EcopagesJsxRenderSession {
-    /**
-     * Runs one render inside the active session scope.
-     *
-     * @remarks
-     * When a render is already active, the current session state is reused and
-     * mirrored back into the JSX SSR scope so nested `renderToString()` calls see
-     * the same HMR-ownership set. When no session exists yet, a new state is
-     * created and published through both the internal async-local store and the
-     * JSX SSR scope bridge. HMR ownership accumulated during the outer scope is
-     * published once when that scope completes.
-     */
-    withActiveScope<T>(render: () => T | Promise<T>): Promise<T>;
-    mergeHmrOwnership(components: ReadonlyArray<EcoComponent | undefined>): void;
-    /**
-     * Resolves the current render-session state from the local async scope first.
-     *
-     * @remarks
-     * The fallback read from `@ecopages/jsx/server` keeps compatibility with code
-     * that still inspects the public SSR scope directly, while the async-local
-     * store remains the authoritative source for renderer-owned bookkeeping.
-     */
-    private getState;
-}

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

@@ -1,84 +0,0 @@
-import { AsyncLocalStorage } from 'node:async_hooks';
-import { getActiveSsrScopeValue, withActiveSsrScopeValue } from '@ecopages/jsx/server';
-import { mergeEjsxHmrOwnership, publishEjsxHmrOwnership } from './ecopages-jsx-hmr-ownership.js';
-export const ECOPAGES_JSX_SSR_RENDER_STATE_KEY = Symbol.for('@ecopages/ecopages-jsx.ssr-render-state');
-const renderStateStorage = new AsyncLocalStorage();
-function ensurePendingHmrFileOwners(state) {
-    if (!state.pendingHmrFileOwners) {
-        state.pendingHmrFileOwners = new Set();
-    }
-    return state.pendingHmrFileOwners;
-}
-function commitPendingHmrOwnership(state) {
-    const pending = state.pendingHmrFileOwners;
-    if (!pending || pending.size === 0) {
-        return;
-    }
-    publishEjsxHmrOwnership(pending);
-    pending.clear();
-}
-async function runWithCommittedHmrOwnership(state, render) {
-    try {
-        return await render();
-    }
-    finally {
-        commitPendingHmrOwnership(state);
-    }
-}
-/**
- * Tracks JSX SSR HMR-ownership state for one active render flow.
- *
- * @remarks
- * The renderer still mirrors this state into `@ecopages/jsx/server` so nested
- * JSX renders and existing SSR-scope probes can observe it, but it also keeps
- * an internal async-local copy. That fallback avoids losing renderer state when
- * host runtimes such as Vite end up loading separate module identities for the
- * JSX server helpers.
- */
-export class EcopagesJsxRenderSession {
-    /**
-     * Runs one render inside the active session scope.
-     *
-     * @remarks
-     * When a render is already active, the current session state is reused and
-     * mirrored back into the JSX SSR scope so nested `renderToString()` calls see
-     * the same HMR-ownership set. When no session exists yet, a new state is
-     * created and published through both the internal async-local store and the
-     * JSX SSR scope bridge. HMR ownership accumulated during the outer scope is
-     * published once when that scope completes.
-     */
-    async withActiveScope(render) {
-        const activeState = renderStateStorage.getStore();
-        if (activeState) {
-            return await withActiveSsrScopeValue(ECOPAGES_JSX_SSR_RENDER_STATE_KEY, activeState, render);
-        }
-        const jsxScopeState = getActiveSsrScopeValue(ECOPAGES_JSX_SSR_RENDER_STATE_KEY);
-        if (jsxScopeState) {
-            ensurePendingHmrFileOwners(jsxScopeState);
-            return await runWithCommittedHmrOwnership(jsxScopeState, () => renderStateStorage.run(jsxScopeState, () => render()));
-        }
-        const state = {
-            pendingHmrFileOwners: new Set(),
-        };
-        return await runWithCommittedHmrOwnership(state, () => renderStateStorage.run(state, () => withActiveSsrScopeValue(ECOPAGES_JSX_SSR_RENDER_STATE_KEY, state, render)));
-    }
-    mergeHmrOwnership(components) {
-        mergeEjsxHmrOwnership(ensurePendingHmrFileOwners(this.getState()), components);
-    }
-    /**
-     * Resolves the current render-session state from the local async scope first.
-     *
-     * @remarks
-     * The fallback read from `@ecopages/jsx/server` keeps compatibility with code
-     * that still inspects the public SSR scope directly, while the async-local
-     * store remains the authoritative source for renderer-owned bookkeeping.
-     */
-    getState() {
-        const state = renderStateStorage.getStore() ??
-            getActiveSsrScopeValue(ECOPAGES_JSX_SSR_RENDER_STATE_KEY);
-        if (!state) {
-            throw new Error('Ecopages JSX SSR render state is unavailable outside the active render scope.');
-        }
-        return state;
-    }
-}