@bleedingdev/modern-js-plugin 3.9.0-ultramodern.4 → 3.9.0-ultramodern.5

package/dist/cjs/runtime/api.js

@@ -74,7 +74,9 @@ function initPluginAPI({ context, plugins }) {
         config: hooks.config.tap,
         onBeforeRender: hooks.onBeforeRender.tap,
         wrapRoot: hooks.wrapRoot.tap,
+        resolveComponent: hooks.resolveComponent.tap,
         pickContext: hooks.pickContext.tap,
+        transformRuntimeContext: hooks.transformRuntimeContext.tap,
         extendStringSSRCollectors: hooks.extendStringSSRCollectors.tap,
         extendStreamSSR: hooks.extendStreamSSR.tap,
         ...extendsPluginApi

package/dist/cjs/runtime/hooks.js

@@ -35,7 +35,9 @@ function initHooks() {
     return {
         onBeforeRender: (0, external_hooks_js_namespaceObject.createAsyncInterruptHook)(),
         wrapRoot: (0, external_hooks_js_namespaceObject.createSyncHook)(),
+        resolveComponent: (0, external_hooks_js_namespaceObject.createSyncHook)(),
         pickContext: (0, external_hooks_js_namespaceObject.createSyncHook)(),
+        transformRuntimeContext: (0, external_hooks_js_namespaceObject.createSyncHook)(),
         config: (0, external_hooks_js_namespaceObject.createCollectSyncHook)(),
         extendStringSSRCollectors: (0, external_hooks_js_namespaceObject.createCollectSyncHook)(),
         extendStreamSSR: (0, external_hooks_js_namespaceObject.createCollectSyncHook)()

package/dist/esm/runtime/api.mjs

@@ -42,7 +42,9 @@ function initPluginAPI({ context, plugins }) {
         config: hooks.config.tap,
         onBeforeRender: hooks.onBeforeRender.tap,
         wrapRoot: hooks.wrapRoot.tap,
+        resolveComponent: hooks.resolveComponent.tap,
         pickContext: hooks.pickContext.tap,
+        transformRuntimeContext: hooks.transformRuntimeContext.tap,
         extendStringSSRCollectors: hooks.extendStringSSRCollectors.tap,
         extendStreamSSR: hooks.extendStreamSSR.tap,
         ...extendsPluginApi

package/dist/esm/runtime/hooks.mjs

@@ -3,7 +3,9 @@ function initHooks() {
     return {
         onBeforeRender: createAsyncInterruptHook(),
         wrapRoot: createSyncHook(),
+        resolveComponent: createSyncHook(),
         pickContext: createSyncHook(),
+        transformRuntimeContext: createSyncHook(),
         config: createCollectSyncHook(),
         extendStringSSRCollectors: createCollectSyncHook(),
         extendStreamSSR: createCollectSyncHook()

package/dist/esm-node/runtime/api.mjs

@@ -43,7 +43,9 @@ function initPluginAPI({ context, plugins }) {
         config: hooks.config.tap,
         onBeforeRender: hooks.onBeforeRender.tap,
         wrapRoot: hooks.wrapRoot.tap,
+        resolveComponent: hooks.resolveComponent.tap,
         pickContext: hooks.pickContext.tap,
+        transformRuntimeContext: hooks.transformRuntimeContext.tap,
         extendStringSSRCollectors: hooks.extendStringSSRCollectors.tap,
         extendStreamSSR: hooks.extendStreamSSR.tap,
         ...extendsPluginApi

package/dist/esm-node/runtime/hooks.mjs

@@ -4,7 +4,9 @@ function initHooks() {
     return {
         onBeforeRender: createAsyncInterruptHook(),
         wrapRoot: createSyncHook(),
+        resolveComponent: createSyncHook(),
         pickContext: createSyncHook(),
+        transformRuntimeContext: createSyncHook(),
         config: createCollectSyncHook(),
         extendStringSSRCollectors: createCollectSyncHook(),
         extendStreamSSR: createCollectSyncHook()

package/dist/types/runtime/index.d.ts

@@ -1,4 +1,5 @@
 export type { Hooks, InternalRuntimeContext, RuntimeContext, RuntimePlugin, RuntimePluginAPI, RuntimePluginExtends, } from '../types/runtime/index.js';
+export type { Collector, ExtendStreamSSRFn, ResolveComponentFn, RuntimeContextProjection, SSRAssetGroup, SSRAssetTransformInfo, SSRHeadData, SSRHeadPart, SSRHtmlFormatting, SSRRenderAsset, SSRRenderInfo, SSRRenderLifecycle, SSRRenderTerminal, SSRRouterData, SSRTemplateChunk, StreamSSRExtender, StreamSSRInfo, StringSSRCollectorsInfo, TransformRuntimeContextFn, } from '../types/runtime/hooks.js';
 export { initPluginAPI } from './api.js';
 export { createRuntimeContext, initRuntimeContext } from './context.js';
 export { initHooks } from './hooks.js';

package/dist/types/server/index.d.ts

@@ -2,3 +2,4 @@ export { initPluginAPI } from './api.js';
 export { createServerContext, initServerContext } from './context.js';
 export { type Hooks, initHooks, type ModifyConfigFn, type OnPrepareFn, type OnResetFn, } from './hooks.js';
 export { createServer, type ServerCreateOptions, server } from './run/index.js';
+export type { BffRuntimeFramework, BffRuntimeRegistry } from './run/types.js';

package/dist/types/server/run/types.d.ts

@@ -1,5 +1,10 @@
 import type { ServerRoute } from '@modern-js/types';
 import type { Plugin } from '../../types/plugin.js';
+/** Registered BFF runtimes. Runtime packages extend this interface. */
+export interface BffRuntimeRegistry {
+    hono: true;
+}
+export type BffRuntimeFramework = keyof BffRuntimeRegistry;
 export type ServerCreateOptions = {
     /** server working directory, and then also dist directory */
     pwd: string;
@@ -11,7 +16,7 @@ export type ServerCreateOptions = {
         sharedDirectory?: string;
         apiDirectory?: string;
         lambdaDirectory?: string;
-        bffRuntimeFramework?: 'hono' | 'effect';
+        bffRuntimeFramework?: BffRuntimeFramework;
     };
 };
 export type ServerRunOptions = {

package/dist/types/types/runtime/api.d.ts

@@ -1,7 +1,7 @@
 import type { PluginHook, PluginHookTap } from '../hooks.js';
 import type { DeepPartial } from '../utils.js';
 import type { RuntimeContext } from './context.js';
-import type { ConfigFn, ExtendStreamSSRFn, ExtendStringSSRCollectorsFn, Hooks, OnBeforeRenderFn, PickContextFn, StringSSRCollectorsInfo, WrapRootFn } from './hooks.js';
+import type { ConfigFn, ExtendStreamSSRFn, ExtendStringSSRCollectorsFn, Hooks, OnBeforeRenderFn, PickContextFn, ResolveComponentFn, StringSSRCollectorsInfo, TransformRuntimeContextFn, WrapRootFn } from './hooks.js';
 import type { RuntimePluginExtends } from './plugin.js';
 export type RuntimePluginAPI<Extends extends RuntimePluginExtends> = Readonly<{
     updateRuntimeContext: (updateContext: DeepPartial<RuntimeContext>) => void;
@@ -9,10 +9,12 @@ export type RuntimePluginAPI<Extends extends RuntimePluginExtends> = Readonly<{
     getRuntimeConfig: () => Readonly<Extends['config']>;
     onBeforeRender: PluginHookTap<OnBeforeRenderFn<Extends['extendContext']>>;
     wrapRoot: PluginHookTap<WrapRootFn>;
+    resolveComponent: PluginHookTap<ResolveComponentFn>;
     pickContext: PluginHookTap<PickContextFn<RuntimeContext>>;
+    transformRuntimeContext: PluginHookTap<TransformRuntimeContextFn<RuntimeContext & Extends['extendContext']>>;
     config: PluginHookTap<ConfigFn<Extends['config']>>;
-    extendStringSSRCollectors: PluginHookTap<ExtendStringSSRCollectorsFn<StringSSRCollectorsInfo>>;
-    extendStreamSSR: PluginHookTap<ExtendStreamSSRFn>;
+    extendStringSSRCollectors: PluginHookTap<ExtendStringSSRCollectorsFn<StringSSRCollectorsInfo<RuntimeContext & Extends['extendContext']>>>;
+    extendStreamSSR: PluginHookTap<ExtendStreamSSRFn<RuntimeContext & Extends['extendContext']>>;
 } & RuntimePluginExtendsAPI<Extends>>;
 export type RuntimePluginExtendsAPI<Extends extends RuntimePluginExtends> = {
     [K in keyof Extends['extendHooks']]: PluginHookTap<Extends['extendHooks'][K] extends PluginHook<infer Args> ? Args extends (...args: any[]) => any ? Args : (...args: any[]) => any : (...args: any[]) => any>;

package/dist/types/types/runtime/hooks.d.ts

@@ -5,7 +5,83 @@ export type ChunkSet = {
     jsChunk: string;
     cssChunk: string;
 };
-export type Collector = {
+export type SSRRenderInfo<RuntimeContext = object> = {
+    /** The original request context, before public or RSC projection. */
+    runtimeContext: RuntimeContext;
+    request: Request;
+    platform: 'node' | 'web';
+    mode: 'string' | 'stream';
+    isRsc: boolean;
+    /** Original renderer resource and configuration; interpreted by extensions. */
+    resource?: object;
+    config?: object;
+};
+export type SSRHeadPart = {
+    toString(): string;
+};
+export type SSRHeadData = Record<'htmlAttributes' | 'bodyAttributes' | 'title' | 'base' | 'link' | 'meta' | 'noscript' | 'script' | 'style', SSRHeadPart> & {
+    priority?: SSRHeadPart;
+};
+export type SSRRenderTerminal = {
+    status: 'complete';
+} | {
+    status: 'fallback';
+    error: unknown;
+} | {
+    status: 'error';
+    error: unknown;
+} | {
+    status: 'cancelled';
+    reason: unknown;
+};
+export type SSRRenderAsset = {
+    url?: string;
+    filename?: string;
+};
+export type SSRAssetGroup<T extends SSRRenderAsset> = {
+    name: string;
+    assets: readonly T[];
+};
+export type SSRAssetTransformInfo<T extends SSRRenderAsset> = {
+    kind: 'style' | 'script';
+    source: 'loadable' | 'template';
+    template: string;
+    groups: readonly SSRAssetGroup<T>[];
+    createAsset: (url: string) => T;
+};
+export type SSRTemplateChunk = {
+    name: 'styles' | 'scripts' | 'data';
+    template: string;
+    placeholder: string;
+    content: string;
+    emittedAssets?: readonly string[];
+    attributes?: Readonly<Record<string, unknown>>;
+};
+export type SSRHtmlFormatting = {
+    attributesToString: (attributes: Record<string, unknown>) => string;
+    hasStylesheetLink: (template: string, href: string) => boolean | undefined;
+};
+export type SSRRouterData = {
+    loaderData?: unknown;
+    errors?: Record<string, unknown> | null;
+};
+export interface SSRRenderLifecycle {
+    /** Native asset objects keep their identity and are formatted after this hook. */
+    transformAssets?: <T extends SSRRenderAsset>(assets: readonly T[], info: SSRAssetTransformInfo<T>) => readonly T[];
+    /** Runs on each prepared chunk before native placeholder substitution. */
+    transformTemplateChunk?: (chunk: SSRTemplateChunk, formatting: SSRHtmlFormatting) => SSRTemplateChunk;
+    /** Raw router data is serialized by the native renderer; undefined uses its fallback. */
+    getRouterData?: () => SSRRouterData | undefined;
+    beforeReact?: () => void;
+    /** Runs before the completed body or shell's head data is read. */
+    completedBody?: (html: string, info: {
+        phase: 'complete' | 'shell';
+    }) => string;
+    getHeadData?: () => SSRHeadData | undefined;
+    /** Exactly one notification for this render attempt. */
+    onTerminal?: (terminal: SSRRenderTerminal) => void;
+}
+export type Collector = SSRRenderLifecycle & {
     collect?: (component: React.ReactElement) => React.ReactElement;
     effect: () => void | Promise<void>;
 };
@@ -13,10 +89,14 @@ import type React from 'react';
 import type { AsyncInterruptHook, CollectSyncHook, SyncHook } from '../hooks.js';
 export type OnBeforeRenderFn<RuntimeContext> = (context: RuntimeContext, interrupt: (info: any) => any) => Promise<any> | any;
 export type ExtendStringSSRCollectorsFn<RuntimeContext> = (context: RuntimeContext) => Collector;
-export type StringSSRCollectorsInfo = {
+export type StringSSRCollectorsInfo<RuntimeContext = object> = {
     chunkSet: ChunkSet;
+    render: SSRRenderInfo<RuntimeContext>;
+};
+export type StreamSSRInfo<RuntimeContext = object> = SSRRenderInfo<RuntimeContext> & {
+    terminalMarker: string;
 };
-export interface StreamSSRExtender {
+export interface StreamSSRExtender extends SSRRenderLifecycle {
     init?: (params: {
         rootElement: React.ReactElement;
         forceStream2String: boolean;
@@ -24,16 +104,34 @@ export interface StreamSSRExtender {
     modifyRootElement?: (rootElement: React.ReactElement) => React.ReactElement;
     getStyleTags?: () => string;
     processStream?: (stream: NodeJS.ReadWriteStream) => NodeJS.ReadWriteStream;
+    processReadableStream?: (stream: ReadableStream<Uint8Array>) => ReadableStream<Uint8Array>;
+    /** Body transforms run after all render transforms, preserving order in each phase. */
+    streamPhase?: 'render' | 'body';
 }
-export type ExtendStreamSSRFn = () => StreamSSRExtender;
+export type ExtendStreamSSRFn<RuntimeContext = object> = (info: StreamSSRInfo<RuntimeContext>) => StreamSSRExtender;
 export type WrapRootFn = (root: React.ComponentType<any>) => React.ComponentType<any>;
+export type ResolveComponentFn = (component: React.ComponentType<any>, options: {
+    name: string;
+}) => React.ComponentType<any>;
 export type PickContextFn<RuntimeContext> = (context: RuntimeContext) => RuntimeContext;
+export type RuntimeContextProjection<RuntimeContext> = {
+    internalContext: RuntimeContext;
+    publicContext: RuntimeContext;
+};
+export type TransformRuntimeContextFn<RuntimeContext> = (projection: RuntimeContextProjection<RuntimeContext>, options: {
+    /** Original request context, unchanged across callbacks in the pipeline. */
+    context: RuntimeContext;
+    /** Whether the application's RSC mode is enabled. */
+    isRsc: boolean;
+}) => RuntimeContextProjection<RuntimeContext>;
 export type ConfigFn<RuntimeConfig> = () => RuntimeConfig;
 export type Hooks<RuntimeConfig, RuntimeContext> = {
     onBeforeRender: AsyncInterruptHook<OnBeforeRenderFn<RuntimeContext>>;
     wrapRoot: SyncHook<WrapRootFn>;
+    resolveComponent: SyncHook<ResolveComponentFn>;
     pickContext: SyncHook<PickContextFn<RuntimeContext>>;
+    transformRuntimeContext: SyncHook<TransformRuntimeContextFn<RuntimeContext>>;
     config: CollectSyncHook<ConfigFn<RuntimeConfig>>;
-    extendStringSSRCollectors: CollectSyncHook<ExtendStringSSRCollectorsFn<StringSSRCollectorsInfo>>;
-    extendStreamSSR: CollectSyncHook<ExtendStreamSSRFn>;
+    extendStringSSRCollectors: CollectSyncHook<ExtendStringSSRCollectorsFn<StringSSRCollectorsInfo<RuntimeContext>>>;
+    extendStreamSSR: CollectSyncHook<ExtendStreamSSRFn<RuntimeContext>>;
 };

package/dist/types/types/server/context.d.ts

@@ -1,4 +1,5 @@
 import type { ServerRoute } from '@modern-js/types';
+import type { BffRuntimeFramework } from '../../server/run/types.js';
 import type { ServerPluginAPI } from './api.js';
 import type { Hooks } from './hooks.js';
 import type { ServerPlugin, ServerPluginExtends } from './plugin.js';
@@ -11,6 +12,7 @@ export type ServerContext<Extends extends ServerPluginExtends> = {
     appDirectory: string;
     apiDirectory?: string;
     lambdaDirectory?: string;
+    bffRuntimeFramework?: BffRuntimeFramework;
     internalDirectory?: string;
     sharedDirectory?: string;
     distDirectory?: string;

package/package.json

@@ -17,7 +17,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.9.0-ultramodern.4",
+  "version": "3.9.0-ultramodern.5",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/cjs/index.js",
   "exports": {
@@ -79,15 +79,15 @@
     }
   },
   "dependencies": {
-    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.9.0-ultramodern.4",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.4",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.4",
+    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.9.0-ultramodern.5",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.5",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.5",
     "@rsbuild/core": "2.2.3",
     "@swc/helpers": "^0.5.23",
     "jiti": "^2.7.0"
   },
   "devDependencies": {
-    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.9.0-ultramodern.4",
+    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.9.0-ultramodern.5",
     "@rslib/core": "1.0.0",
     "@types/node": "^26.4.1",
     "@types/react": "^19.2.18",