@analogjs/platform 3.0.0-alpha.91 → 3.0.0-alpha.92

package/src/lib/nx-plugin/src/utils/versions/ng_19_X/versions.d.ts

@@ -1,13 +1,13 @@
-export declare const V19_X_ANALOG_JS_ROUTER = "^3.0.0-alpha.91";
-export declare const V19_X_ANALOG_JS_CONTENT = "^3.0.0-alpha.91";
+export declare const V19_X_ANALOG_JS_ROUTER = "^3.0.0-alpha.92";
+export declare const V19_X_ANALOG_JS_CONTENT = "^3.0.0-alpha.92";
 export declare const V19_X_MARKED = "^18.0.0";
 export declare const V19_X_MARKED_GFM_HEADING_ID = "^4.1.1";
 export declare const V19_X_MARKED_HIGHLIGHT = "^2.2.1";
 export declare const V19_X_MARKED_MANGLE = "^1.1.10";
 export declare const V19_X_PRISMJS = "^1.29.0";
-export declare const V19_X_ANALOG_JS_PLATFORM = "^3.0.0-alpha.91";
-export declare const V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = "^3.0.0-alpha.91";
-export declare const V19_X_ANALOG_JS_VITEST_ANGULAR = "^3.0.0-alpha.91";
+export declare const V19_X_ANALOG_JS_PLATFORM = "^3.0.0-alpha.92";
+export declare const V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = "^3.0.0-alpha.92";
+export declare const V19_X_ANALOG_JS_VITEST_ANGULAR = "^3.0.0-alpha.92";
 export declare const V19_X_NX_ANGULAR = "^22.0.0";
 export declare const V19_X_NX_VITE = "^22.0.0";
 export declare const V19_X_JSDOM = "^22.0.0";

package/src/lib/nx-plugin/src/utils/versions/ng_19_X/versions.js

@@ -1,14 +1,14 @@
 //#region packages/nx-plugin/src/utils/versions/ng_19_X/versions.ts
-var V19_X_ANALOG_JS_ROUTER = "^3.0.0-alpha.91";
-var V19_X_ANALOG_JS_CONTENT = "^3.0.0-alpha.91";
+var V19_X_ANALOG_JS_ROUTER = "^3.0.0-alpha.92";
+var V19_X_ANALOG_JS_CONTENT = "^3.0.0-alpha.92";
 var V19_X_MARKED = "^18.0.0";
 var V19_X_MARKED_GFM_HEADING_ID = "^4.1.1";
 var V19_X_MARKED_HIGHLIGHT = "^2.2.1";
 var V19_X_MARKED_MANGLE = "^1.1.10";
 var V19_X_PRISMJS = "^1.29.0";
-var V19_X_ANALOG_JS_PLATFORM = "^3.0.0-alpha.91";
-var V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = "^3.0.0-alpha.91";
-var V19_X_ANALOG_JS_VITEST_ANGULAR = "^3.0.0-alpha.91";
+var V19_X_ANALOG_JS_PLATFORM = "^3.0.0-alpha.92";
+var V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = "^3.0.0-alpha.92";
+var V19_X_ANALOG_JS_VITEST_ANGULAR = "^3.0.0-alpha.92";
 var V19_X_NX_VITE = "^22.0.0";
 var V19_X_JSDOM = "^22.0.0";
 var V19_X_VITE_TSCONFIG_PATHS = "^4.2.0";

package/src/lib/nx-plugin/src/utils/versions/ng_19_X/versions.js.map

@@ -1 +1 @@
-{"version":3,"file":"versions.js","names":[],"sources":["../../../../../../../../../nx-plugin/src/utils/versions/ng_19_X/versions.ts"],"sourcesContent":["// V19_X\nexport const V19_X_ANALOG_JS_ROUTER = '^3.0.0-alpha.91';\nexport const V19_X_ANALOG_JS_CONTENT = '^3.0.0-alpha.91';\nexport const V19_X_MARKED = '^18.0.0';\nexport const V19_X_MARKED_GFM_HEADING_ID = '^4.1.1';\nexport const V19_X_MARKED_HIGHLIGHT = '^2.2.1';\nexport const V19_X_MARKED_MANGLE = '^1.1.10';\nexport const V19_X_PRISMJS = '^1.29.0';\n\n// devDependencies\nexport const V19_X_ANALOG_JS_PLATFORM = '^3.0.0-alpha.91';\nexport const V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = '^3.0.0-alpha.91';\nexport const V19_X_ANALOG_JS_VITEST_ANGULAR = '^3.0.0-alpha.91';\nexport const V19_X_NX_ANGULAR = '^22.0.0';\nexport const V19_X_NX_VITE = '^22.0.0';\nexport const V19_X_JSDOM = '^22.0.0';\nexport const V19_X_VITE_TSCONFIG_PATHS = '^4.2.0';\nexport const V19_X_VITEST = '^3.0.0';\nexport const V19_X_VITE = '^6.0.0';\nexport const NX_X_LATEST_VITE = '^8.0.0';\nexport const NX_X_LATEST_VITEST = '^4.0.0';\nexport const NX_X_LATEST_NX = '^23.0.0';\n"],"mappings":";AACA,IAAa,yBAAyB;AACtC,IAAa,0BAA0B;AACvC,IAAa,eAAe;AAC5B,IAAa,8BAA8B;AAC3C,IAAa,yBAAyB;AACtC,IAAa,sBAAsB;AACnC,IAAa,gBAAgB;AAG7B,IAAa,2BAA2B;AACxC,IAAa,sCAAsC;AACnD,IAAa,iCAAiC;AAE9C,IAAa,gBAAgB;AAC7B,IAAa,cAAc;AAC3B,IAAa,4BAA4B;AACzC,IAAa,eAAe;AAC5B,IAAa,aAAa;AAC1B,IAAa,mBAAmB;AAChC,IAAa,qBAAqB;AAClC,IAAa,iBAAiB"}
+{"version":3,"file":"versions.js","names":[],"sources":["../../../../../../../../../nx-plugin/src/utils/versions/ng_19_X/versions.ts"],"sourcesContent":["// V19_X\nexport const V19_X_ANALOG_JS_ROUTER = '^3.0.0-alpha.92';\nexport const V19_X_ANALOG_JS_CONTENT = '^3.0.0-alpha.92';\nexport const V19_X_MARKED = '^18.0.0';\nexport const V19_X_MARKED_GFM_HEADING_ID = '^4.1.1';\nexport const V19_X_MARKED_HIGHLIGHT = '^2.2.1';\nexport const V19_X_MARKED_MANGLE = '^1.1.10';\nexport const V19_X_PRISMJS = '^1.29.0';\n\n// devDependencies\nexport const V19_X_ANALOG_JS_PLATFORM = '^3.0.0-alpha.92';\nexport const V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = '^3.0.0-alpha.92';\nexport const V19_X_ANALOG_JS_VITEST_ANGULAR = '^3.0.0-alpha.92';\nexport const V19_X_NX_ANGULAR = '^22.0.0';\nexport const V19_X_NX_VITE = '^22.0.0';\nexport const V19_X_JSDOM = '^22.0.0';\nexport const V19_X_VITE_TSCONFIG_PATHS = '^4.2.0';\nexport const V19_X_VITEST = '^3.0.0';\nexport const V19_X_VITE = '^6.0.0';\nexport const NX_X_LATEST_VITE = '^8.0.0';\nexport const NX_X_LATEST_VITEST = '^4.0.0';\nexport const NX_X_LATEST_NX = '^23.0.0';\n"],"mappings":";AACA,IAAa,yBAAyB;AACtC,IAAa,0BAA0B;AACvC,IAAa,eAAe;AAC5B,IAAa,8BAA8B;AAC3C,IAAa,yBAAyB;AACtC,IAAa,sBAAsB;AACnC,IAAa,gBAAgB;AAG7B,IAAa,2BAA2B;AACxC,IAAa,sCAAsC;AACnD,IAAa,iCAAiC;AAE9C,IAAa,gBAAgB;AAC7B,IAAa,cAAc;AAC3B,IAAa,4BAA4B;AACzC,IAAa,eAAe;AAC5B,IAAa,aAAa;AAC1B,IAAa,mBAAmB;AAChC,IAAa,qBAAqB;AAClC,IAAa,iBAAiB"}

package/src/lib/options.d.ts

@@ -117,6 +117,14 @@ export interface Options {
 	experimental?: {
 		/** Generate route declarations and enable typed navigation helpers. */
 		typedRouting?: boolean | import("./typed-routes-plugin.js").TypedRoutingOptions;
+		/**
+		* Opt into progressive streaming SSR. When enabled, the SSR build patches
+		* `@angular/core` with a per-`@defer` block resolution hook so
+		* `@analogjs/router`'s `renderStream` can flush the document head first and
+		* each `@defer (hydrate …)` block as it resolves on the server. Has no
+		* effect unless the server entry uses `renderStream`.
+		*/
+		streaming?: boolean;
 	};
 }
 export type { PrerenderContentDir, PrerenderContentFile, PrerenderSitemapConfig, SitemapConfig, SitemapEntry, SitemapExcludeRule, SitemapPriority, SitemapRouteDefinition, SitemapRouteInput, SitemapRouteSource, SitemapTransform };

package/src/lib/platform-plugin.js

@@ -6,13 +6,29 @@ import { contentPlugin } from "./content-plugin.js";
 import { clearClientPageEndpointsPlugin } from "./clear-client-page-endpoint.js";
 import { depsPlugin } from "./deps-plugin.js";
 import { injectHTMLPlugin } from "./ssr/inject-html-plugin.js";
+import { deferStreamingPlugin, streamingSupportedOnAngular } from "./ssr/defer-streaming-plugin.js";
 import { serverModePlugin } from "../server-mode-plugin.js";
 import { typedRoutes } from "./typed-routes-plugin.js";
 import { i18nComponentRegistryPlugin } from "./i18n-component-registry-plugin.js";
 import { analogNitroPlugin } from "./nitro/analog-nitro-plugin.js";
-import "node:module";
-import "node:path";
+import { createRequire } from "node:module";
+import { join } from "node:path";
 //#region packages/platform/src/lib/platform-plugin.ts
+/**
+* The installed `@angular/core` major version, resolved from the workspace root
+* (where the app's Angular is installed). Returns `null` when it cannot be
+* detected, in which case streaming is not blocked and the build-time
+* anchor-drift detection is relied on instead.
+*/
+function getAngularCoreMajor(workspaceRoot) {
+	try {
+		const { version } = createRequire(join(workspaceRoot, "noop.js"))("@angular/core/package.json");
+		const major = Number.parseInt(version.split(".")[0], 10);
+		return Number.isNaN(major) ? null : major;
+	} catch {
+		return null;
+	}
+}
 function platformPlugin(opts = {}) {
 	applyDebugOption(opts.debug, opts.workspaceRoot);
 	const isTest = process.env.NODE_ENV === "test" || !!process.env["VITEST"];
@@ -20,6 +36,16 @@ function platformPlugin(opts = {}) {
 		ssr: true,
 		...opts
 	};
+	if (platformOptions.ssr && platformOptions.experimental?.streaming) {
+		const major = getAngularCoreMajor(platformOptions.workspaceRoot ?? process.cwd());
+		if (!streamingSupportedOnAngular(major)) {
+			console.warn(`[@analogjs/platform] experimental.streaming requires Angular 21+ (detected v${major}); streaming is disabled and rendering falls back to buffered SSR.`);
+			platformOptions.experimental = {
+				...platformOptions.experimental,
+				streaming: false
+			};
+		}
+	}
 	debugPlatform("experimental options resolved", { typedRouting: platformOptions.experimental?.typedRouting });
 	return [
 		...platformOptions.experimental?.typedRouting ? [typedRoutes({
@@ -34,14 +60,19 @@ function platformPlugin(opts = {}) {
 				activateDeferredDebug(command);
 			}
 		},
+		{
+			name: "@analogjs/platform-options",
+			api: { analogOptions: platformOptions }
+		},
 		...!isTest ? [analogNitroPlugin(platformOptions)] : [],
 		...platformOptions.ssr ? [...ssrBuildPlugin(), ...injectHTMLPlugin()] : [],
+		...platformOptions.ssr && platformOptions.experimental?.streaming ? [deferStreamingPlugin()] : [],
 		...!isTest ? depsPlugin(platformOptions) : [],
 		...routerPlugin(platformOptions),
 		analogIntegrationPlugin(platformOptions),
 		...contentPlugin(platformOptions?.content, platformOptions),
 		...platformOptions.i18n ? [i18nComponentRegistryPlugin()] : [],
-		...serverModePlugin(),
+		...serverModePlugin(platformOptions.entryServer),
 		clearClientPageEndpointsPlugin()
 	];
 }

package/src/lib/platform-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform-plugin.js","names":[],"sources":["../../../src/lib/platform-plugin.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport { join } from 'node:path';\nimport { Plugin } from 'vite';\n\nimport { Options } from './options.js';\nimport {\n  activateDeferredDebug,\n  applyDebugOption,\n  debugPlatform,\n} from './utils/debug.js';\nimport { routerPlugin } from './router-plugin.js';\nimport { analogIntegrationPlugin } from './analog-integration-plugin.js';\nimport { ssrBuildPlugin } from './ssr/ssr-build-plugin.js';\nimport { contentPlugin } from './content-plugin.js';\nimport { clearClientPageEndpointsPlugin } from './clear-client-page-endpoint.js';\nimport { depsPlugin } from './deps-plugin.js';\nimport { injectHTMLPlugin } from './ssr/inject-html-plugin.js';\nimport { serverModePlugin } from '../server-mode-plugin.js';\nimport { typedRoutes } from './typed-routes-plugin.js';\nimport { i18nComponentRegistryPlugin } from './i18n-component-registry-plugin.js';\nimport { analogNitroPlugin } from './nitro/analog-nitro-plugin.js';\n\n/**\n * The installed `@angular/core` major version, resolved from the workspace root\n * (where the app's Angular is installed). Returns `null` when it cannot be\n * detected, in which case streaming is not blocked and the build-time\n * anchor-drift detection is relied on instead.\n */\nfunction getAngularCoreMajor(workspaceRoot: string): number | null {\n  try {\n    const req = createRequire(join(workspaceRoot, 'noop.js'));\n    const { version } = req('@angular/core/package.json') as {\n      version: string;\n    };\n    const major = Number.parseInt(version.split('.')[0], 10);\n    return Number.isNaN(major) ? null : major;\n  } catch {\n    return null;\n  }\n}\n\nexport function platformPlugin(opts: Options = {}): Plugin[] {\n  applyDebugOption(opts.debug, opts.workspaceRoot);\n\n  const isTest = process.env['NODE_ENV'] === 'test' || !!process.env['VITEST'];\n  const { ...platformOptions } = {\n    ssr: true,\n    ...opts,\n  };\n\n  debugPlatform('experimental options resolved', {\n    typedRouting: platformOptions.experimental?.typedRouting,\n  });\n\n  return [\n    ...(platformOptions.experimental?.typedRouting\n      ? [\n          typedRoutes({\n            ...(typeof platformOptions.experimental.typedRouting === 'object'\n              ? platformOptions.experimental.typedRouting\n              : {}),\n            workspaceRoot: platformOptions.workspaceRoot,\n            additionalPagesDirs: platformOptions.additionalPagesDirs,\n            additionalContentDirs: platformOptions.additionalContentDirs,\n          }),\n        ]\n      : []),\n    {\n      name: 'analogjs-debug-activate',\n      config(_, { command }) {\n        activateDeferredDebug(command);\n      },\n    },\n    ...(!isTest ? [analogNitroPlugin(platformOptions)] : []),\n    ...(platformOptions.ssr\n      ? [...ssrBuildPlugin(), ...injectHTMLPlugin()]\n      : []),\n    ...(!isTest ? depsPlugin(platformOptions) : []),\n    ...routerPlugin(platformOptions),\n    analogIntegrationPlugin(platformOptions),\n    ...contentPlugin(platformOptions?.content, platformOptions),\n    ...(platformOptions.i18n ? [i18nComponentRegistryPlugin()] : []),\n    ...serverModePlugin(),\n    clearClientPageEndpointsPlugin(),\n  ];\n}\n"],"mappings":";;;;;;;;;;;;;;;AAyCA,SAAgB,eAAe,OAAgB,EAAE,EAAY;AAC3D,kBAAiB,KAAK,OAAO,KAAK,cAAc;CAEhD,MAAM,SAAA,QAAA,IAAA,aAAqC,UAAU,CAAC,CAAC,QAAQ,IAAI;CACnE,MAAM,EAAE,GAAG,oBAAoB;EAC7B,KAAK;EACL,GAAG;EACJ;AAED,eAAc,iCAAiC,EAC7C,cAAc,gBAAgB,cAAc,cAC7C,CAAC;AAEF,QAAO;EACL,GAAI,gBAAgB,cAAc,eAC9B,CACE,YAAY;GACV,GAAI,OAAO,gBAAgB,aAAa,iBAAiB,WACrD,gBAAgB,aAAa,eAC7B,EAAE;GACN,eAAe,gBAAgB;GAC/B,qBAAqB,gBAAgB;GACrC,uBAAuB,gBAAgB;GACxC,CAAC,CACH,GACD,EAAE;EACN;GACE,MAAM;GACN,OAAO,GAAG,EAAE,WAAW;AACrB,0BAAsB,QAAQ;;GAEjC;EACD,GAAI,CAAC,SAAS,CAAC,kBAAkB,gBAAgB,CAAC,GAAG,EAAE;EACvD,GAAI,gBAAgB,MAChB,CAAC,GAAG,gBAAgB,EAAE,GAAG,kBAAkB,CAAC,GAC5C,EAAE;EACN,GAAI,CAAC,SAAS,WAAW,gBAAgB,GAAG,EAAE;EAC9C,GAAG,aAAa,gBAAgB;EAChC,wBAAwB,gBAAgB;EACxC,GAAG,cAAc,iBAAiB,SAAS,gBAAgB;EAC3D,GAAI,gBAAgB,OAAO,CAAC,6BAA6B,CAAC,GAAG,EAAE;EAC/D,GAAG,kBAAkB;EACrB,gCAAgC;EACjC"}
+{"version":3,"file":"platform-plugin.js","names":[],"sources":["../../../src/lib/platform-plugin.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport { join } from 'node:path';\nimport { Plugin } from 'vite';\n\nimport { Options } from './options.js';\nimport {\n  activateDeferredDebug,\n  applyDebugOption,\n  debugPlatform,\n} from './utils/debug.js';\nimport { routerPlugin } from './router-plugin.js';\nimport { analogIntegrationPlugin } from './analog-integration-plugin.js';\nimport { ssrBuildPlugin } from './ssr/ssr-build-plugin.js';\nimport { contentPlugin } from './content-plugin.js';\nimport { clearClientPageEndpointsPlugin } from './clear-client-page-endpoint.js';\nimport { depsPlugin } from './deps-plugin.js';\nimport { injectHTMLPlugin } from './ssr/inject-html-plugin.js';\nimport {\n  deferStreamingPlugin,\n  MIN_STREAMING_ANGULAR_MAJOR,\n  streamingSupportedOnAngular,\n} from './ssr/defer-streaming-plugin.js';\nimport { serverModePlugin } from '../server-mode-plugin.js';\nimport { typedRoutes } from './typed-routes-plugin.js';\nimport { i18nComponentRegistryPlugin } from './i18n-component-registry-plugin.js';\nimport { analogNitroPlugin } from './nitro/analog-nitro-plugin.js';\n\n/**\n * The installed `@angular/core` major version, resolved from the workspace root\n * (where the app's Angular is installed). Returns `null` when it cannot be\n * detected, in which case streaming is not blocked and the build-time\n * anchor-drift detection is relied on instead.\n */\nfunction getAngularCoreMajor(workspaceRoot: string): number | null {\n  try {\n    const req = createRequire(join(workspaceRoot, 'noop.js'));\n    const { version } = req('@angular/core/package.json') as {\n      version: string;\n    };\n    const major = Number.parseInt(version.split('.')[0], 10);\n    return Number.isNaN(major) ? null : major;\n  } catch {\n    return null;\n  }\n}\n\nexport function platformPlugin(opts: Options = {}): Plugin[] {\n  applyDebugOption(opts.debug, opts.workspaceRoot);\n\n  const isTest = process.env['NODE_ENV'] === 'test' || !!process.env['VITEST'];\n  const { ...platformOptions } = {\n    ssr: true,\n    ...opts,\n  };\n\n  // Streaming patches the compiled @angular/core, which needs a supported\n  // Angular version. Turn it off otherwise so the renderer stays buffered.\n  if (platformOptions.ssr && platformOptions.experimental?.streaming) {\n    const major = getAngularCoreMajor(\n      platformOptions.workspaceRoot ?? process.cwd(),\n    );\n    if (!streamingSupportedOnAngular(major)) {\n      console.warn(\n        `[@analogjs/platform] experimental.streaming requires Angular ` +\n          `${MIN_STREAMING_ANGULAR_MAJOR}+ (detected v${major}); streaming is ` +\n          `disabled and rendering falls back to buffered SSR.`,\n      );\n      platformOptions.experimental = {\n        ...platformOptions.experimental,\n        streaming: false,\n      };\n    }\n  }\n\n  debugPlatform('experimental options resolved', {\n    typedRouting: platformOptions.experimental?.typedRouting,\n  });\n\n  return [\n    ...(platformOptions.experimental?.typedRouting\n      ? [\n          typedRoutes({\n            ...(typeof platformOptions.experimental.typedRouting === 'object'\n              ? platformOptions.experimental.typedRouting\n              : {}),\n            workspaceRoot: platformOptions.workspaceRoot,\n            additionalPagesDirs: platformOptions.additionalPagesDirs,\n            additionalContentDirs: platformOptions.additionalContentDirs,\n          }),\n        ]\n      : []),\n    {\n      name: 'analogjs-debug-activate',\n      config(_, { command }) {\n        activateDeferredDebug(command);\n      },\n    },\n    // `nitro()` from `@analogjs/vite-plugin-nitro` reads these as its defaults.\n    {\n      name: '@analogjs/platform-options',\n      api: { analogOptions: platformOptions },\n    },\n    ...(!isTest ? [analogNitroPlugin(platformOptions)] : []),\n    ...(platformOptions.ssr\n      ? [...ssrBuildPlugin(), ...injectHTMLPlugin()]\n      : []),\n    ...(platformOptions.ssr && platformOptions.experimental?.streaming\n      ? [deferStreamingPlugin()]\n      : []),\n    ...(!isTest ? depsPlugin(platformOptions) : []),\n    ...routerPlugin(platformOptions),\n    analogIntegrationPlugin(platformOptions),\n    ...contentPlugin(platformOptions?.content, platformOptions),\n    ...(platformOptions.i18n ? [i18nComponentRegistryPlugin()] : []),\n    ...serverModePlugin(platformOptions.entryServer),\n    clearClientPageEndpointsPlugin(),\n  ];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAS,oBAAoB,eAAsC;AACjE,KAAI;EAEF,MAAM,EAAE,YADI,cAAc,KAAK,eAAe,UAAU,CAAC,CACjC,6BAA6B;EAGrD,MAAM,QAAQ,OAAO,SAAS,QAAQ,MAAM,IAAI,CAAC,IAAI,GAAG;AACxD,SAAO,OAAO,MAAM,MAAM,GAAG,OAAO;SAC9B;AACN,SAAO;;;AAIX,SAAgB,eAAe,OAAgB,EAAE,EAAY;AAC3D,kBAAiB,KAAK,OAAO,KAAK,cAAc;CAEhD,MAAM,SAAA,QAAA,IAAA,aAAqC,UAAU,CAAC,CAAC,QAAQ,IAAI;CACnE,MAAM,EAAE,GAAG,oBAAoB;EAC7B,KAAK;EACL,GAAG;EACJ;AAID,KAAI,gBAAgB,OAAO,gBAAgB,cAAc,WAAW;EAClE,MAAM,QAAQ,oBACZ,gBAAgB,iBAAiB,QAAQ,KAAK,CAC/C;AACD,MAAI,CAAC,4BAA4B,MAAM,EAAE;AACvC,WAAQ,KACN,+EACgD,MAAM,oEAEvD;AACD,mBAAgB,eAAe;IAC7B,GAAG,gBAAgB;IACnB,WAAW;IACZ;;;AAIL,eAAc,iCAAiC,EAC7C,cAAc,gBAAgB,cAAc,cAC7C,CAAC;AAEF,QAAO;EACL,GAAI,gBAAgB,cAAc,eAC9B,CACE,YAAY;GACV,GAAI,OAAO,gBAAgB,aAAa,iBAAiB,WACrD,gBAAgB,aAAa,eAC7B,EAAE;GACN,eAAe,gBAAgB;GAC/B,qBAAqB,gBAAgB;GACrC,uBAAuB,gBAAgB;GACxC,CAAC,CACH,GACD,EAAE;EACN;GACE,MAAM;GACN,OAAO,GAAG,EAAE,WAAW;AACrB,0BAAsB,QAAQ;;GAEjC;EAED;GACE,MAAM;GACN,KAAK,EAAE,eAAe,iBAAiB;GACxC;EACD,GAAI,CAAC,SAAS,CAAC,kBAAkB,gBAAgB,CAAC,GAAG,EAAE;EACvD,GAAI,gBAAgB,MAChB,CAAC,GAAG,gBAAgB,EAAE,GAAG,kBAAkB,CAAC,GAC5C,EAAE;EACN,GAAI,gBAAgB,OAAO,gBAAgB,cAAc,YACrD,CAAC,sBAAsB,CAAC,GACxB,EAAE;EACN,GAAI,CAAC,SAAS,WAAW,gBAAgB,GAAG,EAAE;EAC9C,GAAG,aAAa,gBAAgB;EAChC,wBAAwB,gBAAgB;EACxC,GAAG,cAAc,iBAAiB,SAAS,gBAAgB;EAC3D,GAAI,gBAAgB,OAAO,CAAC,6BAA6B,CAAC,GAAG,EAAE;EAC/D,GAAG,iBAAiB,gBAAgB,YAAY;EAChD,gCAAgC;EACjC"}

package/src/lib/ssr/defer-streaming-plugin.js

@@ -0,0 +1,97 @@
+/**
+* Whether the streaming SSR patch can be applied to the installed Angular.
+* A `null` major (version undetectable) returns `true`: don't block on a failed
+* detection — the plugin's anchor-drift detection catches a real mismatch at
+* build time and falls back to buffered rendering.
+*/
+function streamingSupportedOnAngular(major) {
+	return major === null || major >= 21;
+}
+/**
+* Pure transform that injects the streaming-SSR per-block resolution hook into
+* `@angular/core`'s compiled output. It is the same class of transform as
+* `i18nDefRegistryPlugin` in ./ssr-build-plugin — a string patch of Angular's
+* bundle applied only to SSR builds. Exported separately so it can be unit
+* tested against a bundle string.
+*
+* Two edits, both keyed on single-occurrence anchors in the module that holds
+* the defer runtime:
+*   1. Inside `applyDeferBlockState`, fire `globalThis.__analogSsrDeferCapture`
+*      when a `@defer` block reaches `Complete` on the server, passing the
+*      block's live `lContainer` — this is the per-block resolution signal a
+*      streaming renderer consumes.
+*   2. Expose `collectNativeNodesInLContainer` via `globalThis.__analogSsrInternals`
+*      so the renderer can serialize a block's subtree.
+*
+* Returns `null` when the module is not the one carrying the defer runtime, so
+* it is a no-op on every other Angular module.
+*/
+function injectDeferStreamingHook(code) {
+	const END_ANCHOR = "profiler(ProfilerEvent.DeferBlockStateEnd);";
+	if (!code.includes("function applyDeferBlockState(") || !code.includes(END_ANCHOR)) return null;
+	let out = code.replace(END_ANCHOR, "try { if (newState === DeferBlockState.Complete && typeof ngServerMode !== 'undefined' && ngServerMode && typeof globalThis.__analogSsrDeferCapture === 'function') { globalThis.__analogSsrDeferCapture({ ssrUniqueId: lDetails[SSR_UNIQUE_ID], lContainer, hostLView }); } } catch (e) {}\n  " + END_ANCHOR);
+	if (code.includes("function collectNativeNodesInLContainer(")) out += "\nglobalThis.__analogSsrInternals = Object.assign(globalThis.__analogSsrInternals || {}, { collectNativeNodesInLContainer });\n";
+	return out;
+}
+/**
+* Classify an `@angular/core` module for the streaming patch. The patch anchors
+* on internal symbol names, so when Angular changes those the transform would
+* otherwise become a silent no-op and streaming would degrade to buffered with
+* no signal. This distinguishes "not the target module" (skip quietly) from
+* "this IS the `@defer` runtime module but the anchors drifted" (worth warning).
+*/
+function inspectAngularCoreModule(code) {
+	if (!code.includes("function applyDeferBlockState(")) return { kind: "not-target" };
+	const missing = [];
+	if (!code.includes("profiler(ProfilerEvent.DeferBlockStateEnd);")) missing.push("DeferBlockStateEnd profiler anchor");
+	if (!code.includes("function collectNativeNodesInLContainer(")) missing.push("collectNativeNodesInLContainer");
+	return missing.length === 0 ? { kind: "patchable" } : {
+		kind: "drifted",
+		reason: `missing ${missing.join(", ")}`
+	};
+}
+/**
+* Vite plugin that applies {@link injectDeferStreamingHook} to `@angular/core`
+* during SSR builds, so `@analogjs/router`'s `renderStream` can flush `@defer`
+* blocks as they resolve on the server — without hand-patching node_modules.
+*
+* Only active for SSR. Mirrors the enforce/filter/ssr-gate shape of
+* `i18nDefRegistryPlugin`. If the `@defer` runtime module is found but its
+* anchors have drifted (Angular changed internals), or if it is never
+* encountered at all, the plugin warns rather than silently producing a build
+* that falls back to buffered rendering.
+*/
+function deferStreamingPlugin() {
+	let applied = false;
+	let warnedDrift = false;
+	return {
+		name: "analogjs-defer-streaming",
+		enforce: "post",
+		transform: {
+			filter: { id: /\/@angular\/core\// },
+			handler(code, _id, options) {
+				if (!options?.ssr) return;
+				const info = inspectAngularCoreModule(code);
+				if (info.kind === "not-target") return;
+				if (info.kind === "drifted") {
+					if (!warnedDrift) {
+						warnedDrift = true;
+						this.warn(`experimental streaming SSR: found @angular/core's @defer runtime but could not apply the resolution hook (${info.reason}). The installed Angular version likely changed internals the patch depends on; streaming will fall back to buffered rendering.`);
+					}
+					return;
+				}
+				const out = injectDeferStreamingHook(code);
+				if (!out) return;
+				applied = true;
+				return { code: out };
+			}
+		},
+		buildEnd() {
+			if (!applied && !warnedDrift) this.warn("experimental streaming SSR is enabled but @angular/core's @defer runtime module was never encountered during the SSR build, so the resolution hook was not injected. Streaming will fall back to buffered rendering.");
+		}
+	};
+}
+//#endregion
+export { deferStreamingPlugin, streamingSupportedOnAngular };
+
+//# sourceMappingURL=defer-streaming-plugin.js.map

package/src/lib/ssr/defer-streaming-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer-streaming-plugin.js","names":[],"sources":["../../../../src/lib/ssr/defer-streaming-plugin.ts"],"sourcesContent":["import type { Plugin } from 'vite';\n\n/**\n * Minimum Angular major whose compiled `@angular/core` FESM matches the\n * streaming patch anchors. Incremental hydration is a stable public API from\n * v20 (`withIncrementalHydration`, `@publicApi 20.0`), but v20's FESM inlines\n * the injection anchor's `DeferBlockStateEnd` profiler event to its numeric\n * ordinal, whereas v21+ keeps the symbolic `ProfilerEvent.DeferBlockStateEnd`\n * form the anchor matches on. Keying on the literal ordinal would be fragile\n * (enum values shift between versions), so v21 is the floor.\n */\nexport const MIN_STREAMING_ANGULAR_MAJOR = 21;\n\n/**\n * Whether the streaming SSR patch can be applied to the installed Angular.\n * A `null` major (version undetectable) returns `true`: don't block on a failed\n * detection — the plugin's anchor-drift detection catches a real mismatch at\n * build time and falls back to buffered rendering.\n */\nexport function streamingSupportedOnAngular(major: number | null): boolean {\n  return major === null || major >= MIN_STREAMING_ANGULAR_MAJOR;\n}\n\n/**\n * Pure transform that injects the streaming-SSR per-block resolution hook into\n * `@angular/core`'s compiled output. It is the same class of transform as\n * `i18nDefRegistryPlugin` in ./ssr-build-plugin — a string patch of Angular's\n * bundle applied only to SSR builds. Exported separately so it can be unit\n * tested against a bundle string.\n *\n * Two edits, both keyed on single-occurrence anchors in the module that holds\n * the defer runtime:\n *   1. Inside `applyDeferBlockState`, fire `globalThis.__analogSsrDeferCapture`\n *      when a `@defer` block reaches `Complete` on the server, passing the\n *      block's live `lContainer` — this is the per-block resolution signal a\n *      streaming renderer consumes.\n *   2. Expose `collectNativeNodesInLContainer` via `globalThis.__analogSsrInternals`\n *      so the renderer can serialize a block's subtree.\n *\n * Returns `null` when the module is not the one carrying the defer runtime, so\n * it is a no-op on every other Angular module.\n */\nexport function injectDeferStreamingHook(code: string): string | null {\n  const END_ANCHOR = 'profiler(ProfilerEvent.DeferBlockStateEnd);';\n  if (\n    !code.includes('function applyDeferBlockState(') ||\n    !code.includes(END_ANCHOR)\n  ) {\n    return null;\n  }\n\n  // Wrap the entire guard — not just the call — so a drifted Angular runtime\n  // that still matches the anchors but renamed these locals fails as a silent\n  // no-op instead of throwing a ReferenceError inside applyDeferBlockState.\n  const capture =\n    `try { if (newState === DeferBlockState.Complete && ` +\n    `typeof ngServerMode !== 'undefined' && ngServerMode && ` +\n    `typeof globalThis.__analogSsrDeferCapture === 'function') { ` +\n    `globalThis.__analogSsrDeferCapture({ ssrUniqueId: lDetails[SSR_UNIQUE_ID], lContainer, hostLView }); } } catch (e) {}\\n  `;\n\n  let out = code.replace(END_ANCHOR, capture + END_ANCHOR);\n\n  if (code.includes('function collectNativeNodesInLContainer(')) {\n    out +=\n      '\\nglobalThis.__analogSsrInternals = Object.assign(globalThis.__analogSsrInternals || {}, { collectNativeNodesInLContainer });\\n';\n  }\n\n  return out;\n}\n\n/**\n * Classify an `@angular/core` module for the streaming patch. The patch anchors\n * on internal symbol names, so when Angular changes those the transform would\n * otherwise become a silent no-op and streaming would degrade to buffered with\n * no signal. This distinguishes \"not the target module\" (skip quietly) from\n * \"this IS the `@defer` runtime module but the anchors drifted\" (worth warning).\n */\nexport function inspectAngularCoreModule(\n  code: string,\n):\n  | { kind: 'not-target' }\n  | { kind: 'patchable' }\n  | { kind: 'drifted'; reason: string } {\n  if (!code.includes('function applyDeferBlockState(')) {\n    return { kind: 'not-target' };\n  }\n  const missing: string[] = [];\n  if (!code.includes('profiler(ProfilerEvent.DeferBlockStateEnd);')) {\n    missing.push('DeferBlockStateEnd profiler anchor');\n  }\n  if (!code.includes('function collectNativeNodesInLContainer(')) {\n    missing.push('collectNativeNodesInLContainer');\n  }\n  return missing.length === 0\n    ? { kind: 'patchable' }\n    : { kind: 'drifted', reason: `missing ${missing.join(', ')}` };\n}\n\n/**\n * Vite plugin that applies {@link injectDeferStreamingHook} to `@angular/core`\n * during SSR builds, so `@analogjs/router`'s `renderStream` can flush `@defer`\n * blocks as they resolve on the server — without hand-patching node_modules.\n *\n * Only active for SSR. Mirrors the enforce/filter/ssr-gate shape of\n * `i18nDefRegistryPlugin`. If the `@defer` runtime module is found but its\n * anchors have drifted (Angular changed internals), or if it is never\n * encountered at all, the plugin warns rather than silently producing a build\n * that falls back to buffered rendering.\n */\nexport function deferStreamingPlugin(): Plugin {\n  let applied = false;\n  let warnedDrift = false;\n  return {\n    name: 'analogjs-defer-streaming',\n    enforce: 'post',\n    transform: {\n      filter: {\n        id: /\\/@angular\\/core\\//,\n      },\n      handler(code, _id, options) {\n        if (!options?.ssr) return;\n        const info = inspectAngularCoreModule(code);\n        if (info.kind === 'not-target') return;\n        if (info.kind === 'drifted') {\n          if (!warnedDrift) {\n            warnedDrift = true;\n            this.warn(\n              `experimental streaming SSR: found @angular/core's @defer runtime ` +\n                `but could not apply the resolution hook (${info.reason}). The ` +\n                `installed Angular version likely changed internals the patch ` +\n                `depends on; streaming will fall back to buffered rendering.`,\n            );\n          }\n          return;\n        }\n        const out = injectDeferStreamingHook(code);\n        if (!out) return;\n        applied = true;\n        return { code: out };\n      },\n    },\n    buildEnd() {\n      if (!applied && !warnedDrift) {\n        this.warn(\n          `experimental streaming SSR is enabled but @angular/core's @defer ` +\n            `runtime module was never encountered during the SSR build, so the ` +\n            `resolution hook was not injected. Streaming will fall back to ` +\n            `buffered rendering.`,\n        );\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;AAmBA,SAAgB,4BAA4B,OAA+B;AACzE,QAAO,UAAU,QAAQ,SAAA;;;;;;;;;;;;;;;;;;;;;AAsB3B,SAAgB,yBAAyB,MAA6B;CACpE,MAAM,aAAa;AACnB,KACE,CAAC,KAAK,SAAS,iCAAiC,IAChD,CAAC,KAAK,SAAS,WAAW,CAE1B,QAAO;CAYT,IAAI,MAAM,KAAK,QAAQ,YALrB,oSAK2C,WAAW;AAExD,KAAI,KAAK,SAAS,2CAA2C,CAC3D,QACE;AAGJ,QAAO;;;;;;;;;AAUT,SAAgB,yBACd,MAIsC;AACtC,KAAI,CAAC,KAAK,SAAS,iCAAiC,CAClD,QAAO,EAAE,MAAM,cAAc;CAE/B,MAAM,UAAoB,EAAE;AAC5B,KAAI,CAAC,KAAK,SAAS,8CAA8C,CAC/D,SAAQ,KAAK,qCAAqC;AAEpD,KAAI,CAAC,KAAK,SAAS,2CAA2C,CAC5D,SAAQ,KAAK,iCAAiC;AAEhD,QAAO,QAAQ,WAAW,IACtB,EAAE,MAAM,aAAa,GACrB;EAAE,MAAM;EAAW,QAAQ,WAAW,QAAQ,KAAK,KAAK;EAAI;;;;;;;;;;;;;AAclE,SAAgB,uBAA+B;CAC7C,IAAI,UAAU;CACd,IAAI,cAAc;AAClB,QAAO;EACL,MAAM;EACN,SAAS;EACT,WAAW;GACT,QAAQ,EACN,IAAI,sBACL;GACD,QAAQ,MAAM,KAAK,SAAS;AAC1B,QAAI,CAAC,SAAS,IAAK;IACnB,MAAM,OAAO,yBAAyB,KAAK;AAC3C,QAAI,KAAK,SAAS,aAAc;AAChC,QAAI,KAAK,SAAS,WAAW;AAC3B,SAAI,CAAC,aAAa;AAChB,oBAAc;AACd,WAAK,KACH,6GAC8C,KAAK,OAAO,iIAG3D;;AAEH;;IAEF,MAAM,MAAM,yBAAyB,KAAK;AAC1C,QAAI,CAAC,IAAK;AACV,cAAU;AACV,WAAO,EAAE,MAAM,KAAK;;GAEvB;EACD,WAAW;AACT,OAAI,CAAC,WAAW,CAAC,YACf,MAAK,KACH,uNAID;;EAGN"}

package/src/lib/utils/rolldown.js

@@ -10,6 +10,6 @@ function getBundleOptionsKey() {
 	return isRolldown() ? "rolldownOptions" : "rollupOptions";
 }
 //#endregion
-export { getBundleOptionsKey, getJsTransformConfigKey };
+export { getBundleOptionsKey, getJsTransformConfigKey, isRolldown };
 
 //# sourceMappingURL=rolldown.js.map

package/src/server-mode-plugin.d.ts

@@ -10,4 +10,4 @@ export declare const SERVER_MODE_ID = "virtual:@analogjs/platform/server-mode";
 * first so the flag is set before any application module evaluates. A text
 * replacement cannot do this because Angular is pre-bundled for SSR.
 */
-export declare function serverModePlugin(): Plugin[];
+export declare function serverModePlugin(entryServer?: string): Plugin[];

package/src/server-mode-plugin.js

@@ -1,3 +1,5 @@
+import { resolve } from "node:path";
+import { normalizePath } from "vite";
 //#region packages/platform/src/server-mode-plugin.ts
 var SERVER_MODE_ID = "virtual:@analogjs/platform/server-mode";
 var RESOLVED_SERVER_MODE_ID = `\0${SERVER_MODE_ID}`;
@@ -11,9 +13,19 @@ var RESOLVED_SERVER_MODE_ID = `\0${SERVER_MODE_ID}`;
 * first so the flag is set before any application module evaluates. A text
 * replacement cannot do this because Angular is pre-bundled for SSR.
 */
-function serverModePlugin() {
+function serverModePlugin(entryServer) {
+	let entryServerPath = "";
 	return [{
 		name: "analogjs-server-mode-plugin",
+		configResolved(config) {
+			entryServerPath = normalizePath(resolve(config.root, entryServer ?? "src/main.server.ts"));
+		},
+		transform(code, id, options) {
+			if (options?.ssr && normalizePath(id) === entryServerPath) return {
+				code: `import ${JSON.stringify(SERVER_MODE_ID)};\n${code}`,
+				map: null
+			};
+		},
 		resolveId(id) {
 			return id === "virtual:@analogjs/platform/server-mode" ? RESOLVED_SERVER_MODE_ID : void 0;
 		},

package/src/server-mode-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-mode-plugin.js","names":[],"sources":["../../src/server-mode-plugin.ts"],"sourcesContent":["import { Plugin } from 'vite';\n\nexport const SERVER_MODE_ID = 'virtual:@analogjs/platform/server-mode';\nconst RESOLVED_SERVER_MODE_ID = `\\0${SERVER_MODE_ID}`;\n\n/**\n * Serves a module that sets `globalThis.ngServerMode = true`.\n *\n * Angular decides at provider-creation time whether browser-only features\n * such as event replay apply, and `provideClientHydration()` runs while the\n * app config module evaluates, before `platformServer()` or\n * `provideServerRendering()` set the flag. The SSR entry imports this module\n * first so the flag is set before any application module evaluates. A text\n * replacement cannot do this because Angular is pre-bundled for SSR.\n */\nexport function serverModePlugin(): Plugin[] {\n  return [\n    {\n      name: 'analogjs-server-mode-plugin',\n      resolveId(id) {\n        return id === SERVER_MODE_ID ? RESOLVED_SERVER_MODE_ID : undefined;\n      },\n      load(id) {\n        return id === RESOLVED_SERVER_MODE_ID\n          ? 'globalThis.ngServerMode = true;\\nexport {};\\n'\n          : undefined;\n      },\n    },\n  ];\n}\n"],"mappings":";AAEA,IAAa,iBAAiB;AAC9B,IAAM,0BAA0B,KAAK;;;;;;;;;;;AAYrC,SAAgB,mBAA6B;AAC3C,QAAO,CACL;EACE,MAAM;EACN,UAAU,IAAI;AACZ,UAAO,OAAA,2CAAwB,0BAA0B,KAAA;;EAE3D,KAAK,IAAI;AACP,UAAO,OAAO,0BACV,kDACA,KAAA;;EAEP,CACF"}
+{"version":3,"file":"server-mode-plugin.js","names":[],"sources":["../../src/server-mode-plugin.ts"],"sourcesContent":["import { resolve } from 'node:path';\nimport { Plugin, normalizePath } from 'vite';\n\nexport const SERVER_MODE_ID = 'virtual:@analogjs/platform/server-mode';\nconst RESOLVED_SERVER_MODE_ID = `\\0${SERVER_MODE_ID}`;\n\n/**\n * Serves a module that sets `globalThis.ngServerMode = true`.\n *\n * Angular decides at provider-creation time whether browser-only features\n * such as event replay apply, and `provideClientHydration()` runs while the\n * app config module evaluates, before `platformServer()` or\n * `provideServerRendering()` set the flag. The SSR entry imports this module\n * first so the flag is set before any application module evaluates. A text\n * replacement cannot do this because Angular is pre-bundled for SSR.\n */\nexport function serverModePlugin(entryServer?: string): Plugin[] {\n  let entryServerPath = '';\n\n  return [\n    {\n      name: 'analogjs-server-mode-plugin',\n      configResolved(config) {\n        entryServerPath = normalizePath(\n          resolve(config.root, entryServer ?? 'src/main.server.ts'),\n        );\n      },\n      // Nitro v2 builds `main.server.ts` as the SSR entry directly, so set the\n      // flag there too.\n      transform(code, id, options) {\n        if (options?.ssr && normalizePath(id) === entryServerPath) {\n          return {\n            code: `import ${JSON.stringify(SERVER_MODE_ID)};\\n${code}`,\n            map: null,\n          };\n        }\n        return undefined;\n      },\n      resolveId(id) {\n        return id === SERVER_MODE_ID ? RESOLVED_SERVER_MODE_ID : undefined;\n      },\n      load(id) {\n        return id === RESOLVED_SERVER_MODE_ID\n          ? 'globalThis.ngServerMode = true;\\nexport {};\\n'\n          : undefined;\n      },\n    },\n  ];\n}\n"],"mappings":";;;AAGA,IAAa,iBAAiB;AAC9B,IAAM,0BAA0B,KAAK;;;;;;;;;;;AAYrC,SAAgB,iBAAiB,aAAgC;CAC/D,IAAI,kBAAkB;AAEtB,QAAO,CACL;EACE,MAAM;EACN,eAAe,QAAQ;AACrB,qBAAkB,cAChB,QAAQ,OAAO,MAAM,eAAe,qBAAqB,CAC1D;;EAIH,UAAU,MAAM,IAAI,SAAS;AAC3B,OAAI,SAAS,OAAO,cAAc,GAAG,KAAK,gBACxC,QAAO;IACL,MAAM,UAAU,KAAK,UAAU,eAAe,CAAC,KAAK;IACpD,KAAK;IACN;;EAIL,UAAU,IAAI;AACZ,UAAO,OAAA,2CAAwB,0BAA0B,KAAA;;EAE3D,KAAK,IAAI;AACP,UAAO,OAAO,0BACV,kDACA,KAAA;;EAEP,CACF"}