@qzsy/vinext 0.1.7

package/dist/entries/app-browser-entry.d.ts

@@ -0,0 +1,29 @@
+import { NextRewrite } from "../config/next-config.js";
+import { AppRoute, RouteManifest } from "../routing/app-route-graph.js";
+import { VinextLinkPrefetchRoute, VinextPagesLinkPrefetchRoute } from "../client/vinext-next-data.js";
+
+//#region src/entries/app-browser-entry.d.ts
+/**
+ * Generate the virtual browser entry module.
+ *
+ * This runs in the client (browser). It hydrates the page from the
+ * embedded RSC payload and handles client-side navigation by re-fetching
+ * RSC streams.
+ */
+declare function generateBrowserEntry(routes?: readonly AppRoute[], routeManifest?: RouteManifest | null, pagesPrefetchRoutes?: readonly VinextPagesLinkPrefetchRoute[], rewrites?: {
+  afterFiles: NextRewrite[];
+  beforeFiles: NextRewrite[];
+  fallback: NextRewrite[];
+}): string;
+/**
+ * Filter for routes that should appear in the `__VINEXT_LINK_PREFETCH_ROUTES__`
+ * manifest. Exported so the Pages Router client entry can reuse it when
+ * emitting the same manifest for hybrid builds — see issue #1526 and
+ * `pages-client-entry.ts`.
+ */
+declare function isLinkPrefetchRoute(route: AppRoute): boolean;
+declare function toDocumentOnlyAppRoute(route: AppRoute): VinextLinkPrefetchRoute;
+/** Project an `AppRoute` down to the public `VinextLinkPrefetchRoute` shape. */
+declare function toLinkPrefetchRoute(route: AppRoute): VinextLinkPrefetchRoute;
+//#endregion
+export { generateBrowserEntry, isLinkPrefetchRoute, toDocumentOnlyAppRoute, toLinkPrefetchRoute };

package/dist/entries/app-browser-entry.js

@@ -0,0 +1,83 @@
+import { resolveClientRuntimeModule, resolveRuntimeEntryModule } from "./runtime-entry-module.js";
+//#region src/entries/app-browser-entry.ts
+/**
+* Generate the virtual browser entry module.
+*
+* This runs in the client (browser). It hydrates the page from the
+* embedded RSC payload and handles client-side navigation by re-fetching
+* RSC streams.
+*/
+function generateBrowserEntry(routes = [], routeManifest = null, pagesPrefetchRoutes = [], rewrites = {
+	afterFiles: [],
+	beforeFiles: [],
+	fallback: []
+}) {
+	const entryPath = resolveRuntimeEntryModule("app-browser-entry");
+	const navigationRuntimePath = resolveClientRuntimeModule("navigation-runtime");
+	const prefetchRoutes = routes.map((route) => isLinkPrefetchRoute(route) ? toLinkPrefetchRoute(route) : toDocumentOnlyAppRoute(route));
+	return `import { registerNavigationRuntimeBootstrap } from ${JSON.stringify(navigationRuntimePath)};
+
+window.__VINEXT_LINK_PREFETCH_ROUTES__ = ${JSON.stringify(prefetchRoutes)};
+// Pages route manifest for hybrid ownership decisions. In a hybrid
+// app+pages build the user can land on an App page, so the App browser
+// entry must also expose the Pages manifest (the Pages client entry does
+// the same — whichever entry runs first emits both globals).
+window.__VINEXT_PAGES_LINK_PREFETCH_ROUTES__ = ${JSON.stringify(pagesPrefetchRoutes)};
+window.__VINEXT_CLIENT_REWRITES__ = ${JSON.stringify(rewrites)};
+registerNavigationRuntimeBootstrap({
+    routeManifest: ${buildRouteManifestExpression(routeManifest)}
+});
+import ${JSON.stringify(entryPath)};`;
+}
+/**
+* Filter for routes that should appear in the `__VINEXT_LINK_PREFETCH_ROUTES__`
+* manifest. Exported so the Pages Router client entry can reuse it when
+* emitting the same manifest for hybrid builds — see issue #1526 and
+* `pages-client-entry.ts`.
+*/
+function isLinkPrefetchRoute(route) {
+	if (route.pagePath !== null) return true;
+	return route.routePath === null && route.layouts.length > 0;
+}
+function toDocumentOnlyAppRoute(route) {
+	return {
+		canPrefetchLoadingShell: false,
+		documentOnly: true,
+		patternParts: [...route.patternParts],
+		isDynamic: route.isDynamic
+	};
+}
+/** Project an `AppRoute` down to the public `VinextLinkPrefetchRoute` shape. */
+function toLinkPrefetchRoute(route) {
+	return {
+		canPrefetchLoadingShell: route.loadingPath !== null,
+		patternParts: [...route.patternParts],
+		isDynamic: route.isDynamic
+	};
+}
+function buildRouteManifestExpression(routeManifest) {
+	if (routeManifest === null) return "null";
+	const graph = routeManifest.segmentGraph;
+	return `{
+  graphVersion: ${JSON.stringify(routeManifest.graphVersion)},
+  segmentGraph: {
+    routes: ${buildMapExpression(graph.routes)},
+    pages: ${buildMapExpression(graph.pages)},
+    routeHandlers: ${buildMapExpression(graph.routeHandlers)},
+    layouts: ${buildMapExpression(graph.layouts)},
+    templates: ${buildMapExpression(graph.templates)},
+    slots: ${buildMapExpression(graph.slots)},
+    defaults: ${buildMapExpression(graph.defaults)},
+    slotBindings: ${buildMapExpression(graph.slotBindings)},
+    interceptions: ${buildMapExpression(graph.interceptions)},
+    interceptionsBySlotId: ${buildMapExpression(graph.interceptionsBySlotId)},
+    boundaries: ${buildMapExpression(graph.boundaries)},
+    rootBoundaries: ${buildMapExpression(graph.rootBoundaries)}
+  }
+}`;
+}
+function buildMapExpression(map) {
+	return `new Map(${JSON.stringify(Array.from(map.entries()))})`;
+}
+//#endregion
+export { generateBrowserEntry, isLinkPrefetchRoute, toDocumentOnlyAppRoute, toLinkPrefetchRoute };

package/dist/entries/app-rsc-entry.d.ts

@@ -0,0 +1,81 @@
+import { NextHeader, NextI18nConfig, NextRedirect, NextRewrite } from "../config/next-config.js";
+import { AppRoute } from "../routing/app-route-graph.js";
+import { MetadataFileRoute } from "../server/metadata-routes.js";
+import { ImageConfig } from "../server/image-optimization.js";
+
+//#region src/entries/app-rsc-entry.d.ts
+/**
+ * Resolved config options relevant to App Router request handling.
+ * Passed from the Vite plugin where the full next.config.js is loaded.
+ */
+type AppRouterConfig = {
+  redirects?: NextRedirect[];
+  rewrites?: {
+    beforeFiles: NextRewrite[];
+    afterFiles: NextRewrite[];
+    fallback: NextRewrite[];
+  };
+  headers?: NextHeader[]; /** Extra origins allowed for server action CSRF checks (from experimental.serverActions.allowedOrigins). */
+  allowedOrigins?: string[]; /** Extra origins allowed for dev server access (from allowedDevOrigins). */
+  allowedDevOrigins?: string[]; /** Body size limit for server actions in bytes (from experimental.serverActions.bodySizeLimit). */
+  bodySizeLimit?: number; /** Verbatim body size limit config value (e.g. "2mb") for the "Body exceeded {limit} limit" error. */
+  bodySizeLimitLabel?: string; /** Serialized next.config htmlLimitedBots regexp source. */
+  htmlLimitedBots?: string;
+  /**
+   * Allow-list of keys (from `experimental.clientTraceMetadata`) to surface
+   * from the active OpenTelemetry context as `<meta>` tags in the SSR head.
+   * Undefined or empty disables emission entirely.
+   */
+  clientTraceMetadata?: string[] | undefined;
+  /**
+   * Resolved `assetPrefix` from next.config. Empty string when unset.
+   * Embedded in the generated entry so the App Router prod-server reads
+   * it from the imported module instead of a sidecar JSON file —
+   * matches how the Pages Router entry exposes `vinextConfig.assetPrefix`.
+   *
+   * @see https://nextjs.org/docs/app/api-reference/config/next-config-js/assetPrefix
+   */
+  assetPrefix?: string; /** Route-level expire fallback in seconds for ISR entries with numeric revalidate. */
+  expireTime?: number;
+  /**
+   * Maximum total length (in characters) of the preload `Link` header emitted
+   * during App Router SSR. `0` disables emission. Defaults to 6000.
+   */
+  reactMaxHeadersLength?: number; /** Maximum in-memory cache size in bytes. 0 disables the default memory cache. */
+  cacheMaxMemorySize?: number; /** Inline app CSS into production HTML (from experimental.inlineCss). */
+  inlineCss?: boolean; /** Enables Next.js Cache Components semantics for App Router document HTML. */
+  cacheComponents?: boolean; /** Whether the RSC build discovered any server references. Defaults to true. */
+  hasServerActions?: boolean; /** Internationalization routing config for middleware matcher locale handling. */
+  i18n?: NextI18nConfig | null;
+  imageConfig?: ImageConfig;
+  /**
+   * Absolute path to `app/global-not-found.{tsx,ts,js,jsx}` when present.
+   * When provided, route-miss 404s render this module standalone (it owns its
+   * own `<html>` and `<body>`) instead of wrapping the regular `not-found.tsx`
+   * boundary inside the root layout. Mirrors Next.js 16's
+   * `experimental.globalNotFound` behavior.
+   * @see https://github.com/vercel/next.js/blob/canary/test/e2e/app-dir/global-not-found
+   */
+  globalNotFoundPath?: string | null;
+  /**
+   * When true, the project has a `pages/` directory alongside the App Router.
+   * The generated RSC entry exposes `/__vinext/prerender/pages-static-paths`
+   * so `prerenderPages` can call `getStaticPaths` via `wrangler unstable_startWorker`
+   * in CF Workers builds. `pageRoutes` is loaded from the SSR environment via
+   * `import("./ssr/index.js")`, which re-exports it from
+   * `virtual:vinext-server-entry` when this flag is set.
+   */
+  hasPagesDir?: boolean; /** Exact public/ file routes, using normalized leading-slash pathnames. */
+  publicFiles?: string[]; /** Server-only token used to validate the draft-mode bypass cookie. */
+  draftModeSecret?: string;
+};
+/**
+ * Generate the virtual RSC entry module.
+ *
+ * This runs in the `rsc` Vite environment (react-server condition).
+ * It matches the incoming request URL to an app route, builds the
+ * nested layout + page tree, and renders it to an RSC stream.
+ */
+declare function generateRscEntry(appDir: string, routes: AppRoute[], middlewarePath?: string | null, metadataRoutes?: MetadataFileRoute[], globalErrorPath?: string | null, basePath?: string, trailingSlash?: boolean, config?: AppRouterConfig, instrumentationPath?: string | null): string;
+//#endregion
+export { generateRscEntry };