vinext 0.0.44 → 0.0.46

package/dist/server/app-page-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-page-dispatch.js","names":[],"sources":["../../src/server/app-page-dispatch.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { ClassificationReason } from \"../build/layout-classification-types.js\";\nimport { _consumeRequestScopedCacheLife, type CachedAppPageValue } from \"vinext/shims/cache\";\nimport {\n  consumeDynamicUsage,\n  consumeInvalidDynamicUsageError,\n  getDraftModeCookieHeader,\n  markDynamicUsage,\n  setHeadersContext,\n} from \"vinext/shims/headers\";\nimport { getRequestExecutionContext } from \"vinext/shims/request-context\";\nimport { createRequestContext, runWithRequestContext } from \"vinext/shims/unified-request-context\";\nimport {\n  ensureFetchPatch,\n  getCollectedFetchTags,\n  setCurrentFetchSoftTags,\n} from \"vinext/shims/fetch-cache\";\nimport type { AppOutgoingElements } from \"./app-elements.js\";\nimport { readAppPageCacheResponse } from \"./app-page-cache.js\";\nimport { resolveAppPageParentHttpAccessBoundaryModule } from \"./app-page-boundary.js\";\nimport {\n  buildAppPageSpecialErrorResponse,\n  readAppPageTextStream,\n  resolveAppPageSpecialError,\n  teeAppPageRscStreamForCapture,\n  type AppPageFontPreload,\n  type AppPageSpecialError,\n  type LayoutClassificationOptions,\n} from \"./app-page-execution.js\";\nimport { resolveAppPageMethodResponse } from \"./app-page-method.js\";\nimport {\n  buildAppPageElement,\n  resolveAppPageIntercept,\n  validateAppPageDynamicParams,\n} from \"./app-page-request.js\";\nimport { renderAppPageLifecycle } from \"./app-page-render.js\";\nimport {\n  mergeMiddlewareResponseHeaders,\n  type AppPageMiddlewareContext,\n} from \"./app-page-response.js\";\nimport { createAppPageTreePath } from \"./app-page-route-wiring.js\";\nimport type { AppPageSsrHandler } from \"./app-page-stream.js\";\nimport { createStaticGenerationHeadersContext } from \"./app-static-generation.js\";\nimport { buildPageCacheTags } from \"./implicit-tags.js\";\nimport type { ISRCacheEntry } from \"./isr-cache.js\";\n\ntype AppPageParams = Record<string, string | string[]>;\ntype AppPageElement = ReactNode | Readonly<Record<string, ReactNode>>;\ntype AppPageRenderableElement = ReactNode | AppOutgoingElements;\ntype AppPageBoundaryOnError = (\n  error: unknown,\n  requestInfo: unknown,\n  errorContext: unknown,\n) => unknown;\ntype AppPageDebugLogger = (event: string, detail: string) => void;\ntype AppPageCacheSetter = (\n  key: string,\n  data: CachedAppPageValue,\n  revalidateSeconds: number,\n  tags: string[],\n) => Promise<void>;\ntype AppPageCacheGetter = (key: string) => Promise<ISRCacheEntry | null>;\ntype AppPageBackgroundRegenerationErrorContext = {\n  routerKind: \"App Router\";\n  routePath: string;\n  routeType: \"render\";\n};\ntype AppPageBackgroundRegenerator = (\n  key: string,\n  renderFn: () => Promise<void>,\n  errorContext?: AppPageBackgroundRegenerationErrorContext,\n) => void;\n\ntype AppPageDispatchIntercept<TPage = unknown> = {\n  interceptLayouts?: readonly AppPageModule[] | null;\n  matchedParams: AppPageParams;\n  page: TPage;\n  slotKey: string;\n  sourceRouteIndex: number;\n};\n\ntype AppPageDispatchInterceptOptions<TPage = unknown> = {\n  interceptionContext: string | null;\n  interceptLayouts?: readonly AppPageModule[] | null;\n  interceptPage: TPage;\n  interceptParams: AppPageParams;\n  interceptSlotKey: string;\n};\n\ntype AppPageModule = {\n  default?: unknown;\n};\n\ntype AppPageDispatchRoute = {\n  __buildTimeClassifications?: LayoutClassificationOptions[\"buildTimeClassifications\"];\n  __buildTimeReasons?: LayoutClassificationOptions[\"buildTimeReasons\"];\n  error?: AppPageModule | null;\n  errors?: readonly (AppPageModule | null | undefined)[];\n  forbiddens?: readonly (AppPageModule | null | undefined)[];\n  isDynamic: boolean;\n  layouts: readonly AppPageModule[];\n  layoutTreePositions?: readonly number[];\n  loading?: AppPageModule | null;\n  notFounds?: readonly (AppPageModule | null | undefined)[];\n  params: readonly string[];\n  pattern: string;\n  routeSegments: readonly string[];\n  unauthorizeds?: readonly (AppPageModule | null | undefined)[];\n};\n\ntype DispatchAppPageOptions<TRoute extends AppPageDispatchRoute> = {\n  buildPageElement: (\n    route: TRoute,\n    params: AppPageParams,\n    opts: AppPageDispatchInterceptOptions | undefined,\n    searchParams: URLSearchParams,\n  ) => Promise<AppPageElement>;\n  cleanPathname: string;\n  clearRequestContext: () => void;\n  createRscOnErrorHandler: (pathname: string, routePath: string) => AppPageBoundaryOnError;\n  debugClassification?: (layoutId: string, reason: ClassificationReason) => void;\n  dynamicConfig?: string;\n  dynamicParamsConfig?: boolean;\n  findIntercept: (pathname: string) => AppPageDispatchIntercept | null;\n  generateStaticParams?: ((args: { params: AppPageParams }) => unknown) | null;\n  getFontLinks: () => string[];\n  getFontPreloads: () => AppPageFontPreload[];\n  getFontStyles: () => string[];\n  getNavigationContext: () => unknown;\n  getSourceRoute: (sourceRouteIndex: number) => TRoute | undefined;\n  hasGenerateStaticParams: boolean;\n  hasPageDefaultExport: boolean;\n  hasPageModule: boolean;\n  handlerStart: number;\n  interceptionContext: string | null;\n  isProduction: boolean;\n  isRscRequest: boolean;\n  isrDebug?: AppPageDebugLogger;\n  isrGet: AppPageCacheGetter;\n  isrHtmlKey: (pathname: string) => string;\n  isrRscKey: (pathname: string, mountedSlotsHeader?: string | null) => string;\n  isrSet: AppPageCacheSetter;\n  loadSsrHandler: () => Promise<AppPageSsrHandler>;\n  middlewareContext: AppPageMiddlewareContext;\n  mountedSlotsHeader?: string | null;\n  params: AppPageParams;\n  probeLayoutAt: (layoutIndex: number) => unknown;\n  probePage: () => unknown;\n  renderErrorBoundaryPage: (error: unknown) => Promise<Response | null>;\n  renderHttpAccessFallbackPage: (\n    statusCode: number,\n    opts: {\n      boundaryComponent?: unknown;\n      layouts?: readonly AppPageModule[];\n      matchedParams: AppPageParams;\n    },\n    middlewareContext: AppPageMiddlewareContext | null,\n  ) => Promise<Response | null>;\n  renderToReadableStream: (\n    element: AppPageRenderableElement,\n    options: { onError: AppPageBoundaryOnError },\n  ) => ReadableStream<Uint8Array>;\n  request: Request;\n  revalidateSeconds: number | null;\n  rootForbiddenModule?: AppPageModule | null;\n  rootNotFoundModule?: AppPageModule | null;\n  rootUnauthorizedModule?: AppPageModule | null;\n  route: TRoute;\n  runWithSuppressedHookWarning<T>(probe: () => Promise<T>): Promise<T>;\n  scheduleBackgroundRegeneration: AppPageBackgroundRegenerator;\n  scriptNonce?: string;\n  searchParams: URLSearchParams;\n  setNavigationContext: (context: {\n    params: AppPageParams;\n    pathname: string;\n    searchParams: URLSearchParams;\n  }) => void;\n};\n\nfunction shouldReadAppPageCache(options: {\n  isForceDynamic: boolean;\n  isProduction: boolean;\n  isRscRequest: boolean;\n  revalidateSeconds: number | null;\n  scriptNonce?: string;\n}): boolean {\n  return (\n    options.isProduction &&\n    !options.isForceDynamic &&\n    (options.isRscRequest || !options.scriptNonce) &&\n    options.revalidateSeconds !== null &&\n    options.revalidateSeconds > 0 &&\n    options.revalidateSeconds !== Infinity\n  );\n}\n\nfunction buildAppPageTags(\n  cleanPathname: string,\n  extraTags: string[],\n  routeSegments: readonly string[],\n): string[] {\n  return buildPageCacheTags(cleanPathname, extraTags, [...routeSegments], \"page\");\n}\n\nasync function runAppPageRevalidationContext(\n  options: {\n    cleanPathname: string;\n    dynamicConfig?: string;\n    params: AppPageParams;\n    routePattern: string;\n    routeSegments: readonly string[];\n    setNavigationContext: DispatchAppPageOptions<AppPageDispatchRoute>[\"setNavigationContext\"];\n  },\n  renderFn: () => Promise<{\n    html: string;\n    rscData: ArrayBuffer;\n    tags: string[];\n  }>,\n): Promise<{\n  html: string;\n  rscData: ArrayBuffer;\n  tags: string[];\n}> {\n  const headersContext = createStaticGenerationHeadersContext({\n    dynamicConfig: options.dynamicConfig,\n    routeKind: \"page\",\n    routePattern: options.routePattern,\n  });\n  const requestContext = createRequestContext({\n    headersContext,\n    executionContext: getRequestExecutionContext(),\n    unstableCacheRevalidation: \"foreground\",\n  });\n\n  return runWithRequestContext(requestContext, async () => {\n    ensureFetchPatch();\n    setCurrentFetchSoftTags(buildAppPageTags(options.cleanPathname, [], options.routeSegments));\n    options.setNavigationContext({\n      pathname: options.cleanPathname,\n      searchParams: new URLSearchParams(),\n      params: options.params,\n    });\n    return renderFn();\n  });\n}\n\nfunction getCapturedRscDataPromise(\n  capturedRscDataPromise: Promise<ArrayBuffer> | null,\n): Promise<ArrayBuffer> {\n  if (!capturedRscDataPromise) {\n    throw new Error(\n      \"[vinext] Expected captured RSC data while regenerating an app page cache entry\",\n    );\n  }\n\n  return capturedRscDataPromise;\n}\n\nfunction toInterceptOptions(\n  interceptionContext: string | null,\n  intercept: AppPageDispatchIntercept,\n): AppPageDispatchInterceptOptions {\n  return {\n    interceptionContext,\n    interceptLayouts: intercept.interceptLayouts,\n    interceptPage: intercept.page,\n    interceptParams: intercept.matchedParams,\n    interceptSlotKey: intercept.slotKey,\n  };\n}\n\nexport async function dispatchAppPage<TRoute extends AppPageDispatchRoute>(\n  options: DispatchAppPageOptions<TRoute>,\n): Promise<Response> {\n  const route = options.route;\n  const dynamicConfig = options.dynamicConfig;\n  const currentRevalidateSeconds = options.revalidateSeconds;\n  const isForceStatic = dynamicConfig === \"force-static\";\n  const isDynamicError = dynamicConfig === \"error\";\n  const isForceDynamic = dynamicConfig === \"force-dynamic\";\n\n  setCurrentFetchSoftTags(buildAppPageTags(options.cleanPathname, [], route.routeSegments));\n\n  if (options.hasPageModule && !options.hasPageDefaultExport) {\n    options.clearRequestContext();\n    return new Response(\"Page has no default export\", { status: 500 });\n  }\n\n  const methodResponse = resolveAppPageMethodResponse({\n    dynamicConfig,\n    hasGenerateStaticParams: options.hasGenerateStaticParams,\n    isDynamicRoute: route.isDynamic,\n    middlewareHeaders: options.middlewareContext.headers,\n    request: options.request,\n    revalidateSeconds: currentRevalidateSeconds,\n  });\n  if (methodResponse) {\n    options.clearRequestContext();\n    return methodResponse;\n  }\n\n  if (isForceStatic || isDynamicError) {\n    setHeadersContext(\n      createStaticGenerationHeadersContext({\n        dynamicConfig,\n        routeKind: \"page\",\n        routePattern: route.pattern,\n      }),\n    );\n    options.setNavigationContext({\n      pathname: options.cleanPathname,\n      searchParams: new URLSearchParams(),\n      params: options.params,\n    });\n  }\n\n  if (\n    shouldReadAppPageCache({\n      isForceDynamic,\n      isProduction: options.isProduction,\n      isRscRequest: options.isRscRequest,\n      revalidateSeconds: currentRevalidateSeconds,\n      scriptNonce: options.scriptNonce,\n    })\n  ) {\n    const cachedPageResponse = await readAppPageCacheResponse({\n      cleanPathname: options.cleanPathname,\n      clearRequestContext: options.clearRequestContext,\n      isRscRequest: options.isRscRequest,\n      isrDebug: options.isrDebug,\n      isrGet: options.isrGet,\n      isrHtmlKey: options.isrHtmlKey,\n      isrRscKey: options.isrRscKey,\n      isrSet: options.isrSet,\n      mountedSlotsHeader: options.mountedSlotsHeader,\n      revalidateSeconds: currentRevalidateSeconds ?? 0,\n      renderFreshPageForCache: async () =>\n        runAppPageRevalidationContext(\n          {\n            cleanPathname: options.cleanPathname,\n            dynamicConfig,\n            params: options.params,\n            routePattern: route.pattern,\n            routeSegments: route.routeSegments,\n            setNavigationContext: options.setNavigationContext,\n          },\n          async () => {\n            const revalidatedElement = await options.buildPageElement(\n              route,\n              options.params,\n              undefined,\n              new URLSearchParams(),\n            );\n            const revalidatedOnError = options.createRscOnErrorHandler(\n              options.cleanPathname,\n              route.pattern,\n            );\n            const revalidatedRscStream = options.renderToReadableStream(revalidatedElement, {\n              onError: revalidatedOnError,\n            });\n            const revalidatedRscCapture = teeAppPageRscStreamForCapture(revalidatedRscStream, true);\n            const revalidatedSsrEntry = await options.loadSsrHandler();\n            const revalidatedCapturedRscRef: { value: Promise<ArrayBuffer> | null } = {\n              value: null,\n            };\n            const revalidatedHtmlStream = await revalidatedSsrEntry.handleSsr(\n              revalidatedRscCapture.ssrStream,\n              options.getNavigationContext(),\n              {\n                links: options.getFontLinks(),\n                styles: options.getFontStyles(),\n                preloads: options.getFontPreloads(),\n              },\n              revalidatedRscCapture.sideStream\n                ? {\n                    sideStream: revalidatedRscCapture.sideStream,\n                    capturedRscDataRef: revalidatedCapturedRscRef,\n                  }\n                : undefined,\n            );\n            options.clearRequestContext();\n            const html = await readAppPageTextStream(revalidatedHtmlStream);\n            const rscData = await getCapturedRscDataPromise(revalidatedCapturedRscRef.value);\n            const tags = buildAppPageTags(\n              options.cleanPathname,\n              getCollectedFetchTags(),\n              route.routeSegments,\n            );\n            return { html, rscData, tags };\n          },\n        ),\n      scheduleBackgroundRegeneration(key, renderFn) {\n        options.scheduleBackgroundRegeneration(key, renderFn, {\n          routerKind: \"App Router\",\n          routePath: route.pattern,\n          routeType: \"render\",\n        });\n      },\n    });\n    if (cachedPageResponse) {\n      return cachedPageResponse;\n    }\n  }\n\n  const dynamicParamsResponse = await validateAppPageDynamicParams({\n    clearRequestContext: options.clearRequestContext,\n    enforceStaticParamsOnly: options.dynamicParamsConfig === false,\n    generateStaticParams: options.generateStaticParams,\n    isDynamicRoute: route.isDynamic,\n    logGenerateStaticParamsError(error) {\n      console.error(\"[vinext] generateStaticParams error:\", error);\n    },\n    params: options.params,\n  });\n  if (dynamicParamsResponse) {\n    return dynamicParamsResponse;\n  }\n\n  const interceptResult = await resolveAppPageIntercept<\n    TRoute,\n    unknown,\n    AppPageDispatchInterceptOptions,\n    AppPageElement\n  >({\n    buildPageElement(interceptRoute, interceptParams, interceptOpts, interceptSearchParams) {\n      return options.buildPageElement(\n        interceptRoute,\n        interceptParams,\n        interceptOpts,\n        interceptSearchParams,\n      );\n    },\n    cleanPathname: options.cleanPathname,\n    currentRoute: route,\n    findIntercept(pathname) {\n      return options.findIntercept(pathname);\n    },\n    getRouteParamNames(sourceRoute) {\n      return sourceRoute.params;\n    },\n    getSourceRoute(sourceRouteIndex) {\n      return options.getSourceRoute(sourceRouteIndex);\n    },\n    isRscRequest: options.isRscRequest,\n    renderInterceptResponse(sourceRoute, interceptElement) {\n      const interceptOnError = options.createRscOnErrorHandler(\n        options.cleanPathname,\n        sourceRoute.pattern,\n      );\n      const interceptStream = options.renderToReadableStream(interceptElement, {\n        onError: interceptOnError,\n      });\n      const interceptHeaders = new Headers({\n        \"Content-Type\": \"text/x-component; charset=utf-8\",\n        Vary: \"RSC, Accept\",\n      });\n      mergeMiddlewareResponseHeaders(interceptHeaders, options.middlewareContext.headers);\n      return new Response(interceptStream, {\n        status: options.middlewareContext.status ?? 200,\n        headers: interceptHeaders,\n      });\n    },\n    searchParams: options.searchParams,\n    setNavigationContext: options.setNavigationContext,\n    toInterceptOpts(intercept) {\n      return toInterceptOptions(options.interceptionContext, intercept);\n    },\n  });\n  if (interceptResult.response) {\n    return interceptResult.response;\n  }\n\n  const pageBuildResult = await buildAppPageElement({\n    buildPageElement() {\n      return options.buildPageElement(\n        route,\n        options.params,\n        interceptResult.interceptOpts,\n        options.searchParams,\n      );\n    },\n    renderErrorBoundaryPage(buildError) {\n      return options.renderErrorBoundaryPage(buildError);\n    },\n    renderSpecialError(specialError) {\n      return renderPageSpecialError(options, specialError);\n    },\n    resolveSpecialError: resolveAppPageSpecialError,\n  });\n  if (pageBuildResult.response) {\n    return pageBuildResult.response;\n  }\n\n  return renderAppPageLifecycle({\n    cleanPathname: options.cleanPathname,\n    clearRequestContext: options.clearRequestContext,\n    consumeDynamicUsage,\n    consumeInvalidDynamicUsageError,\n    createRscOnErrorHandler(pathname, routePath) {\n      return options.createRscOnErrorHandler(pathname, routePath);\n    },\n    element: pageBuildResult.element,\n    getDraftModeCookieHeader,\n    getFontLinks: options.getFontLinks,\n    getFontPreloads: options.getFontPreloads,\n    getFontStyles: options.getFontStyles,\n    getNavigationContext: options.getNavigationContext,\n    getPageTags() {\n      return buildAppPageTags(options.cleanPathname, getCollectedFetchTags(), route.routeSegments);\n    },\n    getRequestCacheLife() {\n      return _consumeRequestScopedCacheLife();\n    },\n    handlerStart: options.handlerStart,\n    hasLoadingBoundary: Boolean(route.loading?.default),\n    isDynamicError,\n    isForceDynamic,\n    isForceStatic,\n    isProduction: options.isProduction,\n    isRscRequest: options.isRscRequest,\n    isrDebug: options.isrDebug,\n    isrHtmlKey: options.isrHtmlKey,\n    isrRscKey: options.isrRscKey,\n    isrSet: options.isrSet,\n    layoutCount: route.layouts.length,\n    loadSsrHandler: options.loadSsrHandler,\n    middlewareContext: options.middlewareContext,\n    params: options.params,\n    probeLayoutAt(layoutIndex) {\n      return options.probeLayoutAt(layoutIndex);\n    },\n    probePage() {\n      return options.probePage();\n    },\n    classification: {\n      getLayoutId(index) {\n        const treePosition = route.layoutTreePositions?.[index] ?? 0;\n        return \"layout:\" + createAppPageTreePath([...route.routeSegments], treePosition);\n      },\n      buildTimeClassifications: route.__buildTimeClassifications,\n      buildTimeReasons: route.__buildTimeReasons,\n      debugClassification: options.debugClassification,\n      async runWithIsolatedDynamicScope(fn) {\n        const priorDynamic = consumeDynamicUsage();\n        try {\n          const result = await fn();\n          const dynamicDetected = consumeDynamicUsage();\n          return { result, dynamicDetected };\n        } finally {\n          consumeDynamicUsage();\n          if (priorDynamic) markDynamicUsage();\n        }\n      },\n    },\n    revalidateSeconds: currentRevalidateSeconds,\n    mountedSlotsHeader: options.mountedSlotsHeader,\n    renderErrorBoundaryResponse(renderError) {\n      return options.renderErrorBoundaryPage(renderError);\n    },\n    renderLayoutSpecialError(specialError, layoutIndex) {\n      return renderLayoutSpecialError(options, specialError, layoutIndex);\n    },\n    renderPageSpecialError(specialError) {\n      return renderPageSpecialError(options, specialError);\n    },\n    renderToReadableStream: options.renderToReadableStream,\n    routeHasLocalBoundary: Boolean(\n      route.error?.default || route.errors?.some((errorModule) => errorModule?.default),\n    ),\n    routePattern: route.pattern,\n    runWithSuppressedHookWarning(probe) {\n      return options.runWithSuppressedHookWarning(probe);\n    },\n    scriptNonce: options.scriptNonce,\n    waitUntil(cachePromise) {\n      getRequestExecutionContext()?.waitUntil(cachePromise);\n    },\n  });\n}\n\nasync function renderLayoutSpecialError<TRoute extends AppPageDispatchRoute>(\n  options: DispatchAppPageOptions<TRoute>,\n  specialError: AppPageSpecialError,\n  layoutIndex: number,\n): Promise<Response> {\n  return buildAppPageSpecialErrorResponse({\n    clearRequestContext: options.clearRequestContext,\n    middlewareContext: options.middlewareContext,\n    renderFallbackPage(statusCode) {\n      const parentBoundary = resolveAppPageParentHttpAccessBoundaryModule({\n        layoutIndex,\n        rootForbiddenModule: options.rootForbiddenModule,\n        rootNotFoundModule: options.rootNotFoundModule,\n        rootUnauthorizedModule: options.rootUnauthorizedModule,\n        routeForbiddenModules: options.route.forbiddens,\n        routeNotFoundModules: options.route.notFounds,\n        routeUnauthorizedModules: options.route.unauthorizeds,\n        statusCode,\n      })?.default;\n      return options.renderHttpAccessFallbackPage(\n        statusCode,\n        {\n          boundaryComponent: parentBoundary,\n          layouts: options.route.layouts.slice(0, layoutIndex),\n          matchedParams: options.params,\n        },\n        null,\n      );\n    },\n    requestUrl: options.request.url,\n    specialError,\n  });\n}\n\nasync function renderPageSpecialError<TRoute extends AppPageDispatchRoute>(\n  options: DispatchAppPageOptions<TRoute>,\n  specialError: AppPageSpecialError,\n): Promise<Response> {\n  return buildAppPageSpecialErrorResponse({\n    clearRequestContext: options.clearRequestContext,\n    middlewareContext: options.middlewareContext,\n    renderFallbackPage(statusCode) {\n      return options.renderHttpAccessFallbackPage(\n        statusCode,\n        { matchedParams: options.params },\n        null,\n      );\n    },\n    requestUrl: options.request.url,\n    specialError,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAmLA,SAAS,uBAAuB,SAMpB;AACV,QACE,QAAQ,gBACR,CAAC,QAAQ,mBACR,QAAQ,gBAAgB,CAAC,QAAQ,gBAClC,QAAQ,sBAAsB,QAC9B,QAAQ,oBAAoB,KAC5B,QAAQ,sBAAsB;;AAIlC,SAAS,iBACP,eACA,WACA,eACU;AACV,QAAO,mBAAmB,eAAe,WAAW,CAAC,GAAG,cAAc,EAAE,OAAO;;AAGjF,eAAe,8BACb,SAQA,UASC;AAYD,QAAO,sBANgB,qBAAqB;EAC1C,gBANqB,qCAAqC;GAC1D,eAAe,QAAQ;GACvB,WAAW;GACX,cAAc,QAAQ;GACvB,CAAC;EAGA,kBAAkB,4BAA4B;EAC9C,2BAA2B;EAC5B,CAAC,EAE2C,YAAY;AACvD,oBAAkB;AAClB,0BAAwB,iBAAiB,QAAQ,eAAe,EAAE,EAAE,QAAQ,cAAc,CAAC;AAC3F,UAAQ,qBAAqB;GAC3B,UAAU,QAAQ;GAClB,cAAc,IAAI,iBAAiB;GACnC,QAAQ,QAAQ;GACjB,CAAC;AACF,SAAO,UAAU;GACjB;;AAGJ,SAAS,0BACP,wBACsB;AACtB,KAAI,CAAC,uBACH,OAAM,IAAI,MACR,iFACD;AAGH,QAAO;;AAGT,SAAS,mBACP,qBACA,WACiC;AACjC,QAAO;EACL;EACA,kBAAkB,UAAU;EAC5B,eAAe,UAAU;EACzB,iBAAiB,UAAU;EAC3B,kBAAkB,UAAU;EAC7B;;AAGH,eAAsB,gBACpB,SACmB;CACnB,MAAM,QAAQ,QAAQ;CACtB,MAAM,gBAAgB,QAAQ;CAC9B,MAAM,2BAA2B,QAAQ;CACzC,MAAM,gBAAgB,kBAAkB;CACxC,MAAM,iBAAiB,kBAAkB;CACzC,MAAM,iBAAiB,kBAAkB;AAEzC,yBAAwB,iBAAiB,QAAQ,eAAe,EAAE,EAAE,MAAM,cAAc,CAAC;AAEzF,KAAI,QAAQ,iBAAiB,CAAC,QAAQ,sBAAsB;AAC1D,UAAQ,qBAAqB;AAC7B,SAAO,IAAI,SAAS,8BAA8B,EAAE,QAAQ,KAAK,CAAC;;CAGpE,MAAM,iBAAiB,6BAA6B;EAClD;EACA,yBAAyB,QAAQ;EACjC,gBAAgB,MAAM;EACtB,mBAAmB,QAAQ,kBAAkB;EAC7C,SAAS,QAAQ;EACjB,mBAAmB;EACpB,CAAC;AACF,KAAI,gBAAgB;AAClB,UAAQ,qBAAqB;AAC7B,SAAO;;AAGT,KAAI,iBAAiB,gBAAgB;AACnC,oBACE,qCAAqC;GACnC;GACA,WAAW;GACX,cAAc,MAAM;GACrB,CAAC,CACH;AACD,UAAQ,qBAAqB;GAC3B,UAAU,QAAQ;GAClB,cAAc,IAAI,iBAAiB;GACnC,QAAQ,QAAQ;GACjB,CAAC;;AAGJ,KACE,uBAAuB;EACrB;EACA,cAAc,QAAQ;EACtB,cAAc,QAAQ;EACtB,mBAAmB;EACnB,aAAa,QAAQ;EACtB,CAAC,EACF;EACA,MAAM,qBAAqB,MAAM,yBAAyB;GACxD,eAAe,QAAQ;GACvB,qBAAqB,QAAQ;GAC7B,cAAc,QAAQ;GACtB,UAAU,QAAQ;GAClB,QAAQ,QAAQ;GAChB,YAAY,QAAQ;GACpB,WAAW,QAAQ;GACnB,QAAQ,QAAQ;GAChB,oBAAoB,QAAQ;GAC5B,mBAAmB,4BAA4B;GAC/C,yBAAyB,YACvB,8BACE;IACE,eAAe,QAAQ;IACvB;IACA,QAAQ,QAAQ;IAChB,cAAc,MAAM;IACpB,eAAe,MAAM;IACrB,sBAAsB,QAAQ;IAC/B,EACD,YAAY;IACV,MAAM,qBAAqB,MAAM,QAAQ,iBACvC,OACA,QAAQ,QACR,KAAA,GACA,IAAI,iBAAiB,CACtB;IACD,MAAM,qBAAqB,QAAQ,wBACjC,QAAQ,eACR,MAAM,QACP;IAID,MAAM,wBAAwB,8BAHD,QAAQ,uBAAuB,oBAAoB,EAC9E,SAAS,oBACV,CAAC,EACgF,KAAK;IACvF,MAAM,sBAAsB,MAAM,QAAQ,gBAAgB;IAC1D,MAAM,4BAAoE,EACxE,OAAO,MACR;IACD,MAAM,wBAAwB,MAAM,oBAAoB,UACtD,sBAAsB,WACtB,QAAQ,sBAAsB,EAC9B;KACE,OAAO,QAAQ,cAAc;KAC7B,QAAQ,QAAQ,eAAe;KAC/B,UAAU,QAAQ,iBAAiB;KACpC,EACD,sBAAsB,aAClB;KACE,YAAY,sBAAsB;KAClC,oBAAoB;KACrB,GACD,KAAA,EACL;AACD,YAAQ,qBAAqB;AAQ7B,WAAO;KAAE,MAPI,MAAM,sBAAsB,sBAAsB;KAOhD,SANC,MAAM,0BAA0B,0BAA0B,MAAM;KAMxD,MALX,iBACX,QAAQ,eACR,uBAAuB,EACvB,MAAM,cACP;KAC6B;KAEjC;GACH,+BAA+B,KAAK,UAAU;AAC5C,YAAQ,+BAA+B,KAAK,UAAU;KACpD,YAAY;KACZ,WAAW,MAAM;KACjB,WAAW;KACZ,CAAC;;GAEL,CAAC;AACF,MAAI,mBACF,QAAO;;CAIX,MAAM,wBAAwB,MAAM,6BAA6B;EAC/D,qBAAqB,QAAQ;EAC7B,yBAAyB,QAAQ,wBAAwB;EACzD,sBAAsB,QAAQ;EAC9B,gBAAgB,MAAM;EACtB,6BAA6B,OAAO;AAClC,WAAQ,MAAM,wCAAwC,MAAM;;EAE9D,QAAQ,QAAQ;EACjB,CAAC;AACF,KAAI,sBACF,QAAO;CAGT,MAAM,kBAAkB,MAAM,wBAK5B;EACA,iBAAiB,gBAAgB,iBAAiB,eAAe,uBAAuB;AACtF,UAAO,QAAQ,iBACb,gBACA,iBACA,eACA,sBACD;;EAEH,eAAe,QAAQ;EACvB,cAAc;EACd,cAAc,UAAU;AACtB,UAAO,QAAQ,cAAc,SAAS;;EAExC,mBAAmB,aAAa;AAC9B,UAAO,YAAY;;EAErB,eAAe,kBAAkB;AAC/B,UAAO,QAAQ,eAAe,iBAAiB;;EAEjD,cAAc,QAAQ;EACtB,wBAAwB,aAAa,kBAAkB;GACrD,MAAM,mBAAmB,QAAQ,wBAC/B,QAAQ,eACR,YAAY,QACb;GACD,MAAM,kBAAkB,QAAQ,uBAAuB,kBAAkB,EACvE,SAAS,kBACV,CAAC;GACF,MAAM,mBAAmB,IAAI,QAAQ;IACnC,gBAAgB;IAChB,MAAM;IACP,CAAC;AACF,kCAA+B,kBAAkB,QAAQ,kBAAkB,QAAQ;AACnF,UAAO,IAAI,SAAS,iBAAiB;IACnC,QAAQ,QAAQ,kBAAkB,UAAU;IAC5C,SAAS;IACV,CAAC;;EAEJ,cAAc,QAAQ;EACtB,sBAAsB,QAAQ;EAC9B,gBAAgB,WAAW;AACzB,UAAO,mBAAmB,QAAQ,qBAAqB,UAAU;;EAEpE,CAAC;AACF,KAAI,gBAAgB,SAClB,QAAO,gBAAgB;CAGzB,MAAM,kBAAkB,MAAM,oBAAoB;EAChD,mBAAmB;AACjB,UAAO,QAAQ,iBACb,OACA,QAAQ,QACR,gBAAgB,eAChB,QAAQ,aACT;;EAEH,wBAAwB,YAAY;AAClC,UAAO,QAAQ,wBAAwB,WAAW;;EAEpD,mBAAmB,cAAc;AAC/B,UAAO,uBAAuB,SAAS,aAAa;;EAEtD,qBAAqB;EACtB,CAAC;AACF,KAAI,gBAAgB,SAClB,QAAO,gBAAgB;AAGzB,QAAO,uBAAuB;EAC5B,eAAe,QAAQ;EACvB,qBAAqB,QAAQ;EAC7B;EACA;EACA,wBAAwB,UAAU,WAAW;AAC3C,UAAO,QAAQ,wBAAwB,UAAU,UAAU;;EAE7D,SAAS,gBAAgB;EACzB;EACA,cAAc,QAAQ;EACtB,iBAAiB,QAAQ;EACzB,eAAe,QAAQ;EACvB,sBAAsB,QAAQ;EAC9B,cAAc;AACZ,UAAO,iBAAiB,QAAQ,eAAe,uBAAuB,EAAE,MAAM,cAAc;;EAE9F,sBAAsB;AACpB,UAAO,gCAAgC;;EAEzC,cAAc,QAAQ;EACtB,oBAAoB,QAAQ,MAAM,SAAS,QAAQ;EACnD;EACA;EACA;EACA,cAAc,QAAQ;EACtB,cAAc,QAAQ;EACtB,UAAU,QAAQ;EAClB,YAAY,QAAQ;EACpB,WAAW,QAAQ;EACnB,QAAQ,QAAQ;EAChB,aAAa,MAAM,QAAQ;EAC3B,gBAAgB,QAAQ;EACxB,mBAAmB,QAAQ;EAC3B,QAAQ,QAAQ;EAChB,cAAc,aAAa;AACzB,UAAO,QAAQ,cAAc,YAAY;;EAE3C,YAAY;AACV,UAAO,QAAQ,WAAW;;EAE5B,gBAAgB;GACd,YAAY,OAAO;IACjB,MAAM,eAAe,MAAM,sBAAsB,UAAU;AAC3D,WAAO,YAAY,sBAAsB,CAAC,GAAG,MAAM,cAAc,EAAE,aAAa;;GAElF,0BAA0B,MAAM;GAChC,kBAAkB,MAAM;GACxB,qBAAqB,QAAQ;GAC7B,MAAM,4BAA4B,IAAI;IACpC,MAAM,eAAe,qBAAqB;AAC1C,QAAI;AAGF,YAAO;MAAE,QAFM,MAAM,IAAI;MAER,iBADO,qBAAqB;MACX;cAC1B;AACR,0BAAqB;AACrB,SAAI,aAAc,mBAAkB;;;GAGzC;EACD,mBAAmB;EACnB,oBAAoB,QAAQ;EAC5B,4BAA4B,aAAa;AACvC,UAAO,QAAQ,wBAAwB,YAAY;;EAErD,yBAAyB,cAAc,aAAa;AAClD,UAAO,yBAAyB,SAAS,cAAc,YAAY;;EAErE,uBAAuB,cAAc;AACnC,UAAO,uBAAuB,SAAS,aAAa;;EAEtD,wBAAwB,QAAQ;EAChC,uBAAuB,QACrB,MAAM,OAAO,WAAW,MAAM,QAAQ,MAAM,gBAAgB,aAAa,QAAQ,CAClF;EACD,cAAc,MAAM;EACpB,6BAA6B,OAAO;AAClC,UAAO,QAAQ,6BAA6B,MAAM;;EAEpD,aAAa,QAAQ;EACrB,UAAU,cAAc;AACtB,+BAA4B,EAAE,UAAU,aAAa;;EAExD,CAAC;;AAGJ,eAAe,yBACb,SACA,cACA,aACmB;AACnB,QAAO,iCAAiC;EACtC,qBAAqB,QAAQ;EAC7B,mBAAmB,QAAQ;EAC3B,mBAAmB,YAAY;GAC7B,MAAM,iBAAiB,6CAA6C;IAClE;IACA,qBAAqB,QAAQ;IAC7B,oBAAoB,QAAQ;IAC5B,wBAAwB,QAAQ;IAChC,uBAAuB,QAAQ,MAAM;IACrC,sBAAsB,QAAQ,MAAM;IACpC,0BAA0B,QAAQ,MAAM;IACxC;IACD,CAAC,EAAE;AACJ,UAAO,QAAQ,6BACb,YACA;IACE,mBAAmB;IACnB,SAAS,QAAQ,MAAM,QAAQ,MAAM,GAAG,YAAY;IACpD,eAAe,QAAQ;IACxB,EACD,KACD;;EAEH,YAAY,QAAQ,QAAQ;EAC5B;EACD,CAAC;;AAGJ,eAAe,uBACb,SACA,cACmB;AACnB,QAAO,iCAAiC;EACtC,qBAAqB,QAAQ;EAC7B,mBAAmB,QAAQ;EAC3B,mBAAmB,YAAY;AAC7B,UAAO,QAAQ,6BACb,YACA,EAAE,eAAe,QAAQ,QAAQ,EACjC,KACD;;EAEH,YAAY,QAAQ,QAAQ;EAC5B;EACD,CAAC"}

package/dist/server/app-page-execution.d.ts

@@ -15,11 +15,14 @@ type AppPageFontPreload = {
   type: string;
 };
 type AppPageRscStreamCapture = {
-  capturedRscDataPromise: Promise<ArrayBuffer> | null;
-  responseStream: ReadableStream<Uint8Array>;
+  /** Stream for createFromReadableStream (SSR). Always set. */ssrStream: ReadableStream<Uint8Array>; /** When capturing, the combined embed+capture stream. handleSsr consumes this. */
+  sideStream?: ReadableStream<Uint8Array>;
 };
 type BuildAppPageSpecialErrorResponseOptions = {
   clearRequestContext: () => void;
+  middlewareContext?: {
+    headers: Headers | null;
+  };
   renderFallbackPage?: (statusCode: number) => Promise<Response | null>;
   requestUrl: string;
   specialError: AppPageSpecialError;
@@ -75,5 +78,5 @@ declare function readAppPageBinaryStream(stream: ReadableStream<Uint8Array>): Pr
 declare function teeAppPageRscStreamForCapture(stream: ReadableStream<Uint8Array>, shouldCapture: boolean): AppPageRscStreamCapture;
 declare function buildAppPageFontLinkHeader(preloads: readonly AppPageFontPreload[] | null | undefined): string;
 //#endregion
-export { AppPageFontPreload, AppPageRscStreamCapture, AppPageSpecialError, BuildAppPageSpecialErrorResponseOptions, type ClassificationReason, LayoutClassificationOptions, type LayoutFlags, ProbeAppPageComponentOptions, ProbeAppPageLayoutsOptions, ProbeAppPageLayoutsResult, buildAppPageFontLinkHeader, buildAppPageSpecialErrorResponse, probeAppPageComponent, probeAppPageLayouts, readAppPageBinaryStream, readAppPageTextStream, resolveAppPageSpecialError, teeAppPageRscStreamForCapture };
+export { AppPageFontPreload, AppPageSpecialError, type ClassificationReason, LayoutClassificationOptions, type LayoutFlags, buildAppPageFontLinkHeader, buildAppPageSpecialErrorResponse, probeAppPageComponent, probeAppPageLayouts, readAppPageBinaryStream, readAppPageTextStream, resolveAppPageSpecialError, teeAppPageRscStreamForCapture };
 //# sourceMappingURL=app-page-execution.d.ts.map

package/dist/server/app-page-execution.js

@@ -1,3 +1,4 @@
+import { mergeMiddlewareResponseHeaders } from "./middleware-response-headers.js";
 //#region src/server/app-page-execution.ts
 function isPromiseLike(value) {
 	return Boolean(value && (typeof value === "object" || typeof value === "function") && "then" in value && typeof value.then === "function");
@@ -5,6 +6,15 @@ function isPromiseLike(value) {
 function getAppPageStatusText(statusCode) {
 	return statusCode === 403 ? "Forbidden" : statusCode === 401 ? "Unauthorized" : "Not Found";
 }
+function mergeAppPageSpecialErrorHeaders(response, middlewareContext) {
+	const headers = new Headers(response.headers);
+	mergeMiddlewareResponseHeaders(headers, middlewareContext?.headers ?? null);
+	return new Response(response.body, {
+		headers,
+		status: response.status,
+		statusText: response.statusText
+	});
+}
 function resolveAppPageSpecialError(error) {
 	if (!(error && typeof error === "object" && "digest" in error)) return null;
 	const digest = String(error.digest);
@@ -25,14 +35,19 @@ function resolveAppPageSpecialError(error) {
 async function buildAppPageSpecialErrorResponse(options) {
 	if (options.specialError.kind === "redirect") {
 		options.clearRequestContext();
-		return Response.redirect(new URL(options.specialError.location, options.requestUrl), options.specialError.statusCode);
+		const headers = new Headers({ Location: new URL(options.specialError.location, options.requestUrl).toString() });
+		mergeMiddlewareResponseHeaders(headers, options.middlewareContext?.headers ?? null);
+		return new Response(null, {
+			headers,
+			status: options.specialError.statusCode
+		});
 	}
 	if (options.renderFallbackPage) {
 		const fallbackResponse = await options.renderFallbackPage(options.specialError.statusCode);
-		if (fallbackResponse) return fallbackResponse;
+		if (fallbackResponse) return mergeAppPageSpecialErrorHeaders(fallbackResponse, options.middlewareContext);
 	}
 	options.clearRequestContext();
-	return new Response(getAppPageStatusText(options.specialError.statusCode), { status: options.specialError.statusCode });
+	return mergeAppPageSpecialErrorHeaders(new Response(getAppPageStatusText(options.specialError.statusCode), { status: options.specialError.statusCode }), options.middlewareContext);
 }
 /** See `LayoutFlags` type docblock in app-elements.ts for lifecycle. */
 async function probeAppPageLayouts(options) {
@@ -129,14 +144,11 @@ async function readAppPageBinaryStream(stream) {
 	return buffer.buffer;
 }
 function teeAppPageRscStreamForCapture(stream, shouldCapture) {
-	if (!shouldCapture) return {
-		capturedRscDataPromise: null,
-		responseStream: stream
-	};
-	const [responseStream, captureStream] = stream.tee();
+	if (!shouldCapture) return { ssrStream: stream };
+	const [ssrStream, sideStream] = stream.tee();
 	return {
-		capturedRscDataPromise: readAppPageBinaryStream(captureStream),
-		responseStream
+		ssrStream,
+		sideStream
 	};
 }
 function buildAppPageFontLinkHeader(preloads) {

package/dist/server/app-page-execution.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-page-execution.js","names":[],"sources":["../../src/server/app-page-execution.ts"],"sourcesContent":["import type { LayoutFlags } from \"./app-elements.js\";\nimport type { ClassificationReason } from \"../build/layout-classification-types.js\";\n\nexport type { LayoutFlags };\nexport type { ClassificationReason };\n\nexport type AppPageSpecialError =\n  | { kind: \"redirect\"; location: string; statusCode: number }\n  | { kind: \"http-access-fallback\"; statusCode: number };\n\nexport type AppPageFontPreload = {\n  href: string;\n  type: string;\n};\n\nexport type AppPageRscStreamCapture = {\n  capturedRscDataPromise: Promise<ArrayBuffer> | null;\n  responseStream: ReadableStream<Uint8Array>;\n};\n\nexport type BuildAppPageSpecialErrorResponseOptions = {\n  clearRequestContext: () => void;\n  renderFallbackPage?: (statusCode: number) => Promise<Response | null>;\n  requestUrl: string;\n  specialError: AppPageSpecialError;\n};\n\nexport type ProbeAppPageLayoutsResult = {\n  response: Response | null;\n  layoutFlags: LayoutFlags;\n};\n\nexport type LayoutClassificationOptions = {\n  /** Build-time classifications from segment config or module graph, keyed by layout index. */\n  buildTimeClassifications?: ReadonlyMap<number, \"static\" | \"dynamic\"> | null;\n  /**\n   * Per-layout classification reasons keyed by layout index. Requires\n   * `VINEXT_DEBUG_CLASSIFICATION` at BOTH lifecycle points: at build time so\n   * the plugin patches the `__VINEXT_CLASS_REASONS` dispatch stub, and at\n   * runtime so the route object actually calls it. Setting the flag only at\n   * runtime leaves the stub returning `null`, and every build-time classified\n   * layout will fall through to `{ layer: \"no-classifier\" }` in the debug\n   * channel. The hot path never reads this and the wire payload is unchanged.\n   */\n  buildTimeReasons?: ReadonlyMap<number, ClassificationReason> | null;\n  /**\n   * Emits one log line per layout with the classification reason, keyed by\n   * layout ID. Set by the generator when `VINEXT_DEBUG_CLASSIFICATION` is\n   * active. When undefined, the probe loop skips debug emission entirely.\n   */\n  debugClassification?: (layoutId: string, reason: ClassificationReason) => void;\n  /** Maps layout index to its layout ID (e.g. \"layout:/blog\"). */\n  getLayoutId: (layoutIndex: number) => string;\n  /** Runs a function with isolated dynamic usage tracking per layout. */\n  runWithIsolatedDynamicScope: <T>(fn: () => T) => Promise<{ result: T; dynamicDetected: boolean }>;\n};\n\nexport type ProbeAppPageLayoutsOptions = {\n  layoutCount: number;\n  onLayoutError: (error: unknown, layoutIndex: number) => Promise<Response | null>;\n  probeLayoutAt: (layoutIndex: number) => unknown;\n  runWithSuppressedHookWarning<T>(probe: () => Promise<T>): Promise<T>;\n  /** When provided, enables per-layout static/dynamic classification. */\n  classification?: LayoutClassificationOptions | null;\n};\n\nexport type ProbeAppPageComponentOptions = {\n  awaitAsyncResult: boolean;\n  onError: (error: unknown) => Promise<Response | null>;\n  probePage: () => unknown;\n  runWithSuppressedHookWarning<T>(probe: () => Promise<T>): Promise<T>;\n};\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return Boolean(\n    value &&\n    (typeof value === \"object\" || typeof value === \"function\") &&\n    \"then\" in value &&\n    typeof value.then === \"function\",\n  );\n}\n\nfunction getAppPageStatusText(statusCode: number): string {\n  return statusCode === 403 ? \"Forbidden\" : statusCode === 401 ? \"Unauthorized\" : \"Not Found\";\n}\n\nexport function resolveAppPageSpecialError(error: unknown): AppPageSpecialError | null {\n  if (!(error && typeof error === \"object\" && \"digest\" in error)) {\n    return null;\n  }\n\n  const digest = String(error.digest);\n\n  if (digest.startsWith(\"NEXT_REDIRECT;\")) {\n    const parts = digest.split(\";\");\n    return {\n      kind: \"redirect\",\n      location: decodeURIComponent(parts[2]),\n      statusCode: parts[3] ? parseInt(parts[3], 10) : 307,\n    };\n  }\n\n  if (digest === \"NEXT_NOT_FOUND\" || digest.startsWith(\"NEXT_HTTP_ERROR_FALLBACK;\")) {\n    return {\n      kind: \"http-access-fallback\",\n      statusCode: digest === \"NEXT_NOT_FOUND\" ? 404 : parseInt(digest.split(\";\")[1], 10),\n    };\n  }\n\n  return null;\n}\n\nexport async function buildAppPageSpecialErrorResponse(\n  options: BuildAppPageSpecialErrorResponseOptions,\n): Promise<Response> {\n  if (options.specialError.kind === \"redirect\") {\n    options.clearRequestContext();\n    return Response.redirect(\n      new URL(options.specialError.location, options.requestUrl),\n      options.specialError.statusCode,\n    );\n  }\n\n  if (options.renderFallbackPage) {\n    const fallbackResponse = await options.renderFallbackPage(options.specialError.statusCode);\n    if (fallbackResponse) {\n      return fallbackResponse;\n    }\n  }\n\n  options.clearRequestContext();\n  return new Response(getAppPageStatusText(options.specialError.statusCode), {\n    status: options.specialError.statusCode,\n  });\n}\n\n/** See `LayoutFlags` type docblock in app-elements.ts for lifecycle. */\nexport async function probeAppPageLayouts(\n  options: ProbeAppPageLayoutsOptions,\n): Promise<ProbeAppPageLayoutsResult> {\n  const layoutFlags: Record<string, \"s\" | \"d\"> = {};\n  const cls = options.classification ?? null;\n\n  const response = await options.runWithSuppressedHookWarning(async () => {\n    for (let layoutIndex = options.layoutCount - 1; layoutIndex >= 0; layoutIndex--) {\n      const buildTimeResult = cls?.buildTimeClassifications?.get(layoutIndex);\n\n      if (cls && buildTimeResult) {\n        // Build-time classified (Layer 1 or Layer 2): skip dynamic isolation,\n        // but still probe for special errors (redirects, not-found).\n        layoutFlags[cls.getLayoutId(layoutIndex)] = buildTimeResult === \"static\" ? \"s\" : \"d\";\n        if (cls.debugClassification) {\n          // `no-classifier` is the documented fallback for a layout that was\n          // build-time classified but whose reason payload is absent — either\n          // because the build was run without `VINEXT_DEBUG_CLASSIFICATION` or\n          // because no Layer 1/2 classifier attached a reason. This is the sole\n          // producer of the variant; see `layout-classification-types.ts`.\n          cls.debugClassification(\n            cls.getLayoutId(layoutIndex),\n            cls.buildTimeReasons?.get(layoutIndex) ?? { layer: \"no-classifier\" },\n          );\n        }\n        const errorResponse = await probeLayoutForErrors(options, layoutIndex);\n        if (errorResponse) return errorResponse;\n        continue;\n      }\n\n      if (cls) {\n        // Layer 3: probe with isolated dynamic scope to detect per-layout\n        // dynamic API usage (headers(), cookies(), connection(), etc.)\n        try {\n          const { dynamicDetected } = await cls.runWithIsolatedDynamicScope(() =>\n            options.probeLayoutAt(layoutIndex),\n          );\n          layoutFlags[cls.getLayoutId(layoutIndex)] = dynamicDetected ? \"d\" : \"s\";\n          if (cls.debugClassification) {\n            cls.debugClassification(cls.getLayoutId(layoutIndex), {\n              layer: \"runtime-probe\",\n              outcome: dynamicDetected ? \"dynamic\" : \"static\",\n            });\n          }\n        } catch (error) {\n          // Probe failed — conservatively treat as dynamic.\n          layoutFlags[cls.getLayoutId(layoutIndex)] = \"d\";\n          if (cls.debugClassification) {\n            cls.debugClassification(cls.getLayoutId(layoutIndex), {\n              layer: \"runtime-probe\",\n              outcome: \"dynamic\",\n              error: error instanceof Error ? error.message : String(error),\n            });\n          }\n          const errorResponse = await options.onLayoutError(error, layoutIndex);\n          if (errorResponse) return errorResponse;\n        }\n        continue;\n      }\n\n      // No classification options — original behavior\n      const errorResponse = await probeLayoutForErrors(options, layoutIndex);\n      if (errorResponse) return errorResponse;\n    }\n\n    return null;\n  });\n\n  return { response, layoutFlags };\n}\n\nasync function probeLayoutForErrors(\n  options: ProbeAppPageLayoutsOptions,\n  layoutIndex: number,\n): Promise<Response | null> {\n  try {\n    const layoutResult = options.probeLayoutAt(layoutIndex);\n    if (isPromiseLike(layoutResult)) {\n      await layoutResult;\n    }\n  } catch (error) {\n    return options.onLayoutError(error, layoutIndex);\n  }\n  return null;\n}\n\nexport async function probeAppPageComponent(\n  options: ProbeAppPageComponentOptions,\n): Promise<Response | null> {\n  return options.runWithSuppressedHookWarning(async () => {\n    try {\n      const pageResult = options.probePage();\n      if (isPromiseLike(pageResult)) {\n        if (options.awaitAsyncResult) {\n          await pageResult;\n        } else {\n          void Promise.resolve(pageResult).catch(() => {});\n        }\n      }\n    } catch (error) {\n      return options.onError(error);\n    }\n\n    return null;\n  });\n}\n\nexport async function readAppPageTextStream(stream: ReadableStream<Uint8Array>): Promise<string> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  const chunks: string[] = [];\n\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) {\n      break;\n    }\n    chunks.push(decoder.decode(value, { stream: true }));\n  }\n\n  chunks.push(decoder.decode());\n  return chunks.join(\"\");\n}\n\nexport async function readAppPageBinaryStream(\n  stream: ReadableStream<Uint8Array>,\n): Promise<ArrayBuffer> {\n  const reader = stream.getReader();\n  const chunks: Uint8Array[] = [];\n  let totalLength = 0;\n\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) {\n      break;\n    }\n    chunks.push(value);\n    totalLength += value.byteLength;\n  }\n\n  const buffer = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of chunks) {\n    buffer.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n\n  return buffer.buffer;\n}\n\nexport function teeAppPageRscStreamForCapture(\n  stream: ReadableStream<Uint8Array>,\n  shouldCapture: boolean,\n): AppPageRscStreamCapture {\n  if (!shouldCapture) {\n    return {\n      capturedRscDataPromise: null,\n      responseStream: stream,\n    };\n  }\n\n  const [responseStream, captureStream] = stream.tee();\n  return {\n    capturedRscDataPromise: readAppPageBinaryStream(captureStream),\n    responseStream,\n  };\n}\n\nexport function buildAppPageFontLinkHeader(\n  preloads: readonly AppPageFontPreload[] | null | undefined,\n): string {\n  if (!preloads || preloads.length === 0) {\n    return \"\";\n  }\n\n  return preloads\n    .map((preload) => `<${preload.href}>; rel=preload; as=font; type=${preload.type}; crossorigin`)\n    .join(\", \");\n}\n"],"mappings":"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"}
+{"version":3,"file":"app-page-execution.js","names":[],"sources":["../../src/server/app-page-execution.ts"],"sourcesContent":["import type { LayoutFlags } from \"./app-elements.js\";\nimport type { ClassificationReason } from \"../build/layout-classification-types.js\";\nimport { mergeMiddlewareResponseHeaders } from \"./middleware-response-headers.js\";\n\nexport type { LayoutFlags };\nexport type { ClassificationReason };\n\nexport type AppPageSpecialError =\n  | { kind: \"redirect\"; location: string; statusCode: number }\n  | { kind: \"http-access-fallback\"; statusCode: number };\n\nexport type AppPageFontPreload = {\n  href: string;\n  type: string;\n};\n\ntype AppPageRscStreamCapture = {\n  /** Stream for createFromReadableStream (SSR). Always set. */\n  ssrStream: ReadableStream<Uint8Array>;\n  /** When capturing, the combined embed+capture stream. handleSsr consumes this. */\n  sideStream?: ReadableStream<Uint8Array>;\n};\n\ntype BuildAppPageSpecialErrorResponseOptions = {\n  clearRequestContext: () => void;\n  middlewareContext?: { headers: Headers | null };\n  renderFallbackPage?: (statusCode: number) => Promise<Response | null>;\n  requestUrl: string;\n  specialError: AppPageSpecialError;\n};\n\ntype ProbeAppPageLayoutsResult = {\n  response: Response | null;\n  layoutFlags: LayoutFlags;\n};\n\nexport type LayoutClassificationOptions = {\n  /** Build-time classifications from segment config or module graph, keyed by layout index. */\n  buildTimeClassifications?: ReadonlyMap<number, \"static\" | \"dynamic\"> | null;\n  /**\n   * Per-layout classification reasons keyed by layout index. Requires\n   * `VINEXT_DEBUG_CLASSIFICATION` at BOTH lifecycle points: at build time so\n   * the plugin patches the `__VINEXT_CLASS_REASONS` dispatch stub, and at\n   * runtime so the route object actually calls it. Setting the flag only at\n   * runtime leaves the stub returning `null`, and every build-time classified\n   * layout will fall through to `{ layer: \"no-classifier\" }` in the debug\n   * channel. The hot path never reads this and the wire payload is unchanged.\n   */\n  buildTimeReasons?: ReadonlyMap<number, ClassificationReason> | null;\n  /**\n   * Emits one log line per layout with the classification reason, keyed by\n   * layout ID. Set by the generator when `VINEXT_DEBUG_CLASSIFICATION` is\n   * active. When undefined, the probe loop skips debug emission entirely.\n   */\n  debugClassification?: (layoutId: string, reason: ClassificationReason) => void;\n  /** Maps layout index to its layout ID (e.g. \"layout:/blog\"). */\n  getLayoutId: (layoutIndex: number) => string;\n  /** Runs a function with isolated dynamic usage tracking per layout. */\n  runWithIsolatedDynamicScope: <T>(fn: () => T) => Promise<{ result: T; dynamicDetected: boolean }>;\n};\n\ntype ProbeAppPageLayoutsOptions = {\n  layoutCount: number;\n  onLayoutError: (error: unknown, layoutIndex: number) => Promise<Response | null>;\n  probeLayoutAt: (layoutIndex: number) => unknown;\n  runWithSuppressedHookWarning<T>(probe: () => Promise<T>): Promise<T>;\n  /** When provided, enables per-layout static/dynamic classification. */\n  classification?: LayoutClassificationOptions | null;\n};\n\ntype ProbeAppPageComponentOptions = {\n  awaitAsyncResult: boolean;\n  onError: (error: unknown) => Promise<Response | null>;\n  probePage: () => unknown;\n  runWithSuppressedHookWarning<T>(probe: () => Promise<T>): Promise<T>;\n};\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return Boolean(\n    value &&\n    (typeof value === \"object\" || typeof value === \"function\") &&\n    \"then\" in value &&\n    typeof value.then === \"function\",\n  );\n}\n\nfunction getAppPageStatusText(statusCode: number): string {\n  return statusCode === 403 ? \"Forbidden\" : statusCode === 401 ? \"Unauthorized\" : \"Not Found\";\n}\n\nfunction mergeAppPageSpecialErrorHeaders(\n  response: Response,\n  middlewareContext: { headers: Headers | null } | undefined,\n): Response {\n  const headers = new Headers(response.headers);\n  mergeMiddlewareResponseHeaders(headers, middlewareContext?.headers ?? null);\n\n  return new Response(response.body, {\n    headers,\n    status: response.status,\n    statusText: response.statusText,\n  });\n}\n\nexport function resolveAppPageSpecialError(error: unknown): AppPageSpecialError | null {\n  if (!(error && typeof error === \"object\" && \"digest\" in error)) {\n    return null;\n  }\n\n  const digest = String(error.digest);\n\n  if (digest.startsWith(\"NEXT_REDIRECT;\")) {\n    const parts = digest.split(\";\");\n    return {\n      kind: \"redirect\",\n      location: decodeURIComponent(parts[2]),\n      statusCode: parts[3] ? parseInt(parts[3], 10) : 307,\n    };\n  }\n\n  if (digest === \"NEXT_NOT_FOUND\" || digest.startsWith(\"NEXT_HTTP_ERROR_FALLBACK;\")) {\n    return {\n      kind: \"http-access-fallback\",\n      statusCode: digest === \"NEXT_NOT_FOUND\" ? 404 : parseInt(digest.split(\";\")[1], 10),\n    };\n  }\n\n  return null;\n}\n\nexport async function buildAppPageSpecialErrorResponse(\n  options: BuildAppPageSpecialErrorResponseOptions,\n): Promise<Response> {\n  if (options.specialError.kind === \"redirect\") {\n    options.clearRequestContext();\n    const headers = new Headers({\n      Location: new URL(options.specialError.location, options.requestUrl).toString(),\n    });\n    // Middleware may contribute response headers here, but redirect() owns the\n    // status. Do not apply middlewareContext.status on special-error responses.\n    mergeMiddlewareResponseHeaders(headers, options.middlewareContext?.headers ?? null);\n\n    return new Response(null, {\n      headers,\n      status: options.specialError.statusCode,\n    });\n  }\n\n  if (options.renderFallbackPage) {\n    const fallbackResponse = await options.renderFallbackPage(options.specialError.statusCode);\n    if (fallbackResponse) {\n      return mergeAppPageSpecialErrorHeaders(fallbackResponse, options.middlewareContext);\n    }\n  }\n\n  options.clearRequestContext();\n  return mergeAppPageSpecialErrorHeaders(\n    new Response(getAppPageStatusText(options.specialError.statusCode), {\n      status: options.specialError.statusCode,\n    }),\n    options.middlewareContext,\n  );\n}\n\n/** See `LayoutFlags` type docblock in app-elements.ts for lifecycle. */\nexport async function probeAppPageLayouts(\n  options: ProbeAppPageLayoutsOptions,\n): Promise<ProbeAppPageLayoutsResult> {\n  const layoutFlags: Record<string, \"s\" | \"d\"> = {};\n  const cls = options.classification ?? null;\n\n  const response = await options.runWithSuppressedHookWarning(async () => {\n    for (let layoutIndex = options.layoutCount - 1; layoutIndex >= 0; layoutIndex--) {\n      const buildTimeResult = cls?.buildTimeClassifications?.get(layoutIndex);\n\n      if (cls && buildTimeResult) {\n        // Build-time classified (Layer 1 or Layer 2): skip dynamic isolation,\n        // but still probe for special errors (redirects, not-found).\n        layoutFlags[cls.getLayoutId(layoutIndex)] = buildTimeResult === \"static\" ? \"s\" : \"d\";\n        if (cls.debugClassification) {\n          // `no-classifier` is the documented fallback for a layout that was\n          // build-time classified but whose reason payload is absent — either\n          // because the build was run without `VINEXT_DEBUG_CLASSIFICATION` or\n          // because no Layer 1/2 classifier attached a reason. This is the sole\n          // producer of the variant; see `layout-classification-types.ts`.\n          cls.debugClassification(\n            cls.getLayoutId(layoutIndex),\n            cls.buildTimeReasons?.get(layoutIndex) ?? { layer: \"no-classifier\" },\n          );\n        }\n        const errorResponse = await probeLayoutForErrors(options, layoutIndex);\n        if (errorResponse) return errorResponse;\n        continue;\n      }\n\n      if (cls) {\n        // Layer 3: probe with isolated dynamic scope to detect per-layout\n        // dynamic API usage (headers(), cookies(), connection(), etc.)\n        try {\n          const { dynamicDetected } = await cls.runWithIsolatedDynamicScope(() =>\n            options.probeLayoutAt(layoutIndex),\n          );\n          layoutFlags[cls.getLayoutId(layoutIndex)] = dynamicDetected ? \"d\" : \"s\";\n          if (cls.debugClassification) {\n            cls.debugClassification(cls.getLayoutId(layoutIndex), {\n              layer: \"runtime-probe\",\n              outcome: dynamicDetected ? \"dynamic\" : \"static\",\n            });\n          }\n        } catch (error) {\n          // Probe failed — conservatively treat as dynamic.\n          layoutFlags[cls.getLayoutId(layoutIndex)] = \"d\";\n          if (cls.debugClassification) {\n            cls.debugClassification(cls.getLayoutId(layoutIndex), {\n              layer: \"runtime-probe\",\n              outcome: \"dynamic\",\n              error: error instanceof Error ? error.message : String(error),\n            });\n          }\n          const errorResponse = await options.onLayoutError(error, layoutIndex);\n          if (errorResponse) return errorResponse;\n        }\n        continue;\n      }\n\n      // No classification options — original behavior\n      const errorResponse = await probeLayoutForErrors(options, layoutIndex);\n      if (errorResponse) return errorResponse;\n    }\n\n    return null;\n  });\n\n  return { response, layoutFlags };\n}\n\nasync function probeLayoutForErrors(\n  options: ProbeAppPageLayoutsOptions,\n  layoutIndex: number,\n): Promise<Response | null> {\n  try {\n    const layoutResult = options.probeLayoutAt(layoutIndex);\n    if (isPromiseLike(layoutResult)) {\n      await layoutResult;\n    }\n  } catch (error) {\n    return options.onLayoutError(error, layoutIndex);\n  }\n  return null;\n}\n\nexport async function probeAppPageComponent(\n  options: ProbeAppPageComponentOptions,\n): Promise<Response | null> {\n  return options.runWithSuppressedHookWarning(async () => {\n    try {\n      const pageResult = options.probePage();\n      if (isPromiseLike(pageResult)) {\n        if (options.awaitAsyncResult) {\n          await pageResult;\n        } else {\n          void Promise.resolve(pageResult).catch(() => {});\n        }\n      }\n    } catch (error) {\n      return options.onError(error);\n    }\n\n    return null;\n  });\n}\n\nexport async function readAppPageTextStream(stream: ReadableStream<Uint8Array>): Promise<string> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  const chunks: string[] = [];\n\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) {\n      break;\n    }\n    chunks.push(decoder.decode(value, { stream: true }));\n  }\n\n  chunks.push(decoder.decode());\n  return chunks.join(\"\");\n}\n\nexport async function readAppPageBinaryStream(\n  stream: ReadableStream<Uint8Array>,\n): Promise<ArrayBuffer> {\n  const reader = stream.getReader();\n  const chunks: Uint8Array[] = [];\n  let totalLength = 0;\n\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) {\n      break;\n    }\n    chunks.push(value);\n    totalLength += value.byteLength;\n  }\n\n  const buffer = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of chunks) {\n    buffer.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n\n  return buffer.buffer;\n}\n\nexport function teeAppPageRscStreamForCapture(\n  stream: ReadableStream<Uint8Array>,\n  shouldCapture: boolean,\n): AppPageRscStreamCapture {\n  if (!shouldCapture) {\n    return {\n      ssrStream: stream,\n    };\n  }\n\n  const [ssrStream, sideStream] = stream.tee();\n  return {\n    ssrStream,\n    sideStream,\n  };\n}\n\nexport function buildAppPageFontLinkHeader(\n  preloads: readonly AppPageFontPreload[] | null | undefined,\n): string {\n  if (!preloads || preloads.length === 0) {\n    return \"\";\n  }\n\n  return preloads\n    .map((preload) => `<${preload.href}>; rel=preload; as=font; type=${preload.type}; crossorigin`)\n    .join(\", \");\n}\n"],"mappings":"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"}

package/dist/server/app-page-head.d.ts

@@ -0,0 +1,55 @@
+import { MetadataFileRoute } from "./metadata-routes.js";
+import { AppPageParams } from "./app-page-boundary.js";
+import { Metadata, Viewport } from "../shims/metadata.js";
+
+//#region src/server/app-page-head.d.ts
+type AppPageSearchParams = Record<string, string | string[]>;
+type AppPageHeadModule = Record<string, unknown>;
+type AppPageHeadParallelRoute<TModule extends AppPageHeadModule = AppPageHeadModule> = {
+  layoutModule?: TModule | null;
+  layoutModules?: readonly (TModule | null | undefined)[] | null;
+  pageModule?: TModule | null;
+  params?: AppPageParams | null;
+  routeSegments?: readonly string[] | null;
+};
+type AppPageHeadSlot<TModule extends AppPageHeadModule = AppPageHeadModule> = {
+  layout?: TModule | null;
+  page?: TModule | null;
+};
+type ResolveActiveParallelRouteHeadInputsOptions<TModule extends AppPageHeadModule = AppPageHeadModule> = {
+  interceptLayouts?: readonly (TModule | null | undefined)[] | null;
+  interceptPage?: TModule | null;
+  interceptParams?: AppPageParams | null;
+  interceptSlotKey?: string | null;
+  params: AppPageParams;
+  routeSegments: readonly string[];
+  slots?: Record<string, AppPageHeadSlot<TModule>> | null;
+};
+type ResolveAppPageHeadOptions<TModule extends AppPageHeadModule = AppPageHeadModule> = {
+  fallbackOnFileMetadataError?: boolean;
+  layoutModules: readonly (TModule | null | undefined)[];
+  layoutTreePositions?: readonly number[] | null;
+  metadataRoutes: readonly MetadataFileRoute[];
+  pageModule?: TModule | null;
+  parallelRoutes?: readonly AppPageHeadParallelRoute<TModule>[] | null;
+  params: AppPageParams;
+  routePath: string;
+  routeSegments?: readonly string[] | null;
+  searchParams?: URLSearchParams | null;
+};
+type ResolveAppPageHeadResult = {
+  hasSearchParams: boolean;
+  metadata: Metadata | null;
+  pageSearchParams: AppPageSearchParams;
+  viewport: Viewport;
+};
+type AppPageSearchParamsCollection = {
+  hasSearchParams: boolean;
+  pageSearchParams: AppPageSearchParams;
+};
+declare function resolveActiveParallelRouteHeadInputs<TModule extends AppPageHeadModule>(options: ResolveActiveParallelRouteHeadInputsOptions<TModule>): AppPageHeadParallelRoute<TModule>[];
+declare function collectAppPageSearchParams(searchParams: URLSearchParams | null | undefined): AppPageSearchParamsCollection;
+declare function resolveAppPageHead<TModule extends AppPageHeadModule>(options: ResolveAppPageHeadOptions<TModule>): Promise<ResolveAppPageHeadResult>;
+//#endregion
+export { collectAppPageSearchParams, resolveActiveParallelRouteHeadInputs, resolveAppPageHead };
+//# sourceMappingURL=app-page-head.d.ts.map

package/dist/server/app-page-head.js

@@ -0,0 +1,196 @@
+import { mergeMetadataEntries, mergeViewport, resolveModuleMetadata, resolveModuleViewport } from "../shims/metadata.js";
+import { resolveAppPageSegmentParams } from "./app-page-params.js";
+import { applyFileBasedMetadata } from "./file-based-metadata.js";
+//#region src/server/app-page-head.ts
+function resolveActiveParallelRouteHeadInputs(options) {
+	return Object.entries(options.slots ?? {}).map(([slotKey, slot]) => {
+		if (options.interceptSlotKey === slotKey && options.interceptPage) return {
+			layoutModules: options.interceptLayouts ?? [],
+			pageModule: options.interceptPage,
+			params: options.interceptParams ?? options.params,
+			routeSegments: options.routeSegments
+		};
+		return {
+			layoutModules: slot.layout ? [slot.layout] : [],
+			pageModule: slot.page,
+			params: options.params,
+			routeSegments: options.routeSegments
+		};
+	});
+}
+function isPresent(value) {
+	return value !== null && value !== void 0;
+}
+function collectAppPageSearchParams(searchParams) {
+	const pageSearchParams = Object.create(null);
+	let hasSearchParams = false;
+	searchParams?.forEach((value, key) => {
+		hasSearchParams = true;
+		const currentValue = pageSearchParams[key];
+		if (Array.isArray(currentValue)) {
+			pageSearchParams[key] = [...currentValue, value];
+			return;
+		}
+		if (currentValue !== void 0) {
+			pageSearchParams[key] = [currentValue, value];
+			return;
+		}
+		pageSearchParams[key] = value;
+	});
+	return {
+		hasSearchParams,
+		pageSearchParams
+	};
+}
+function createMetadataSources(metadataResults, routeSegments, layoutTreePositions, pageMetadata, includePageSource) {
+	const metadataSources = metadataResults.map((metadata, index) => ({
+		routeSegments: routeSegments.slice(0, layoutTreePositions[index] ?? 0),
+		metadata
+	}));
+	if (includePageSource) metadataSources.push({
+		routeSegments,
+		metadata: pageMetadata
+	});
+	return metadataSources;
+}
+function createLayoutInputs(layoutModules, layoutTreePositions) {
+	const layoutInputs = [];
+	for (let index = 0; index < layoutModules.length; index++) {
+		const layoutModule = layoutModules[index];
+		if (!isPresent(layoutModule)) continue;
+		layoutInputs.push({
+			module: layoutModule,
+			treePosition: layoutTreePositions[index] ?? 0
+		});
+	}
+	return layoutInputs;
+}
+async function resolveLayoutMetadata(layoutInputs, params, routeSegments) {
+	const layoutMetadataPromises = [];
+	let accumulatedMetadata = Promise.resolve({});
+	for (const layoutInput of layoutInputs) {
+		const parentForLayout = accumulatedMetadata;
+		const layoutParams = resolveAppPageSegmentParams(routeSegments, layoutInput.treePosition, params);
+		const metadataPromise = resolveModuleMetadata(layoutInput.module, layoutParams, void 0, parentForLayout);
+		layoutMetadataPromises.push(metadataPromise);
+		metadataPromise.catch(() => null);
+		accumulatedMetadata = metadataPromise.then(async (metadataResult) => {
+			if (metadataResult) return mergeMetadataEntries([{ metadata: await parentForLayout }, { metadata: metadataResult }]);
+			return parentForLayout;
+		});
+		accumulatedMetadata.catch(() => null);
+	}
+	return Promise.all(layoutMetadataPromises);
+}
+async function resolveLayoutViewport(layoutInputs, params, routeSegments) {
+	return Promise.all(layoutInputs.map((layoutInput) => {
+		const layoutParams = resolveAppPageSegmentParams(routeSegments, layoutInput.treePosition, params);
+		return resolveModuleViewport(layoutInput.module, layoutParams);
+	}));
+}
+async function resolveParallelRouteHead(parallelRoute, fallbackParams, fallbackRouteSegments, pageSearchParams, parent) {
+	const params = parallelRoute.params ?? fallbackParams;
+	const routeSegments = parallelRoute.routeSegments ?? fallbackRouteSegments;
+	const metadataResults = [];
+	const viewportResults = [];
+	const metadataSources = [];
+	let accumulatedMetadata = parent;
+	const layoutModules = [...parallelRoute.layoutModules ?? [], parallelRoute.layoutModule].filter(isPresent);
+	const layoutViewportPromises = layoutModules.map((layoutModule) => resolveModuleViewport(layoutModule, params));
+	const pageViewportPromise = parallelRoute.pageModule ? resolveModuleViewport(parallelRoute.pageModule, params) : Promise.resolve(null);
+	for (const layoutViewportPromise of layoutViewportPromises) layoutViewportPromise.catch(() => null);
+	pageViewportPromise.catch(() => null);
+	for (const layoutModule of layoutModules) {
+		const layoutMetadata = await resolveModuleMetadata(layoutModule, params, void 0, accumulatedMetadata);
+		metadataResults.push(layoutMetadata);
+		metadataSources.push({
+			metadata: layoutMetadata,
+			routeSegments
+		});
+		if (layoutMetadata) {
+			accumulatedMetadata = accumulatedMetadata.then(async (parentMetadata) => mergeMetadataEntries([{ metadata: parentMetadata }, { metadata: layoutMetadata }]));
+			accumulatedMetadata.catch(() => null);
+		}
+	}
+	if (parallelRoute.pageModule) {
+		const pageMetadata = await resolveModuleMetadata(parallelRoute.pageModule, params, pageSearchParams, accumulatedMetadata);
+		metadataResults.push(pageMetadata);
+		metadataSources.push({
+			metadata: pageMetadata,
+			routeSegments
+		});
+	}
+	viewportResults.push(...await Promise.all(layoutViewportPromises));
+	const pageViewport = await pageViewportPromise;
+	if (parallelRoute.pageModule) viewportResults.push(pageViewport);
+	return {
+		metadataResults,
+		metadataSources,
+		viewportResults
+	};
+}
+async function resolveAppPageHead(options) {
+	const routeSegments = options.routeSegments ?? [];
+	const layoutTreePositions = options.layoutTreePositions ?? [];
+	const layoutInputs = createLayoutInputs(options.layoutModules, layoutTreePositions);
+	const layoutSourcePositions = layoutInputs.map((input) => input.treePosition);
+	const { hasSearchParams, pageSearchParams } = collectAppPageSearchParams(options.searchParams);
+	const layoutMetadataPromise = resolveLayoutMetadata(layoutInputs, options.params, routeSegments);
+	const layoutViewportPromise = resolveLayoutViewport(layoutInputs, options.params, routeSegments);
+	const layoutMetadataResultsForParent = layoutMetadataPromise.then((metadataResults) => metadataResults.filter(isPresent));
+	layoutMetadataResultsForParent.catch(() => null);
+	const pageParentPromise = layoutMetadataResultsForParent.then((metadataResults) => metadataResults.length > 0 ? mergeMetadataEntries(metadataResults.map((metadata) => ({ metadata }))) : {});
+	pageParentPromise.catch(() => null);
+	const pageMetadataPromise = options.pageModule ? resolveModuleMetadata(options.pageModule, options.params, pageSearchParams, pageParentPromise) : Promise.resolve(null);
+	const pageViewportPromise = options.pageModule ? resolveModuleViewport(options.pageModule, options.params) : Promise.resolve(null);
+	const parallelRouteHeadPromise = Promise.all((options.parallelRoutes ?? []).map((parallelRoute) => resolveParallelRouteHead(parallelRoute, options.params, routeSegments, pageSearchParams, pageParentPromise)));
+	const [layoutMetadataResults, layoutViewportResults, pageMetadata, pageViewport, parallelRouteHeads] = await Promise.all([
+		layoutMetadataPromise,
+		layoutViewportPromise,
+		pageMetadataPromise,
+		pageViewportPromise,
+		parallelRouteHeadPromise
+	]);
+	const parallelMetadataResults = parallelRouteHeads.flatMap((head) => head.metadataResults);
+	const parallelViewportResults = parallelRouteHeads.flatMap((head) => head.viewportResults);
+	const parallelMetadataSources = parallelRouteHeads.flatMap((head) => head.metadataSources);
+	const metadataEntries = [
+		...layoutMetadataResults.filter(isPresent).map((metadata) => ({ metadata })),
+		...pageMetadata ? [{
+			isPage: true,
+			metadata: pageMetadata
+		}] : [],
+		...parallelMetadataResults.filter(isPresent).map((metadata) => ({
+			contributesTitle: false,
+			metadata
+		}))
+	];
+	const viewportList = [
+		...layoutViewportResults.filter(isPresent),
+		...pageViewport ? [pageViewport] : [],
+		...parallelViewportResults.filter(isPresent)
+	];
+	const resolvedMetadataBase = metadataEntries.length > 0 ? mergeMetadataEntries(metadataEntries) : null;
+	const metadataSources = createMetadataSources(layoutMetadataResults, routeSegments, layoutSourcePositions, pageMetadata, Boolean(options.pageModule));
+	metadataSources.push(...parallelMetadataSources);
+	let metadata = resolvedMetadataBase;
+	try {
+		metadata = await applyFileBasedMetadata(resolvedMetadataBase, options.routePath, options.params, options.metadataRoutes, {
+			routeSegments,
+			metadataSources
+		});
+	} catch (error) {
+		if (!options.fallbackOnFileMetadataError) throw error;
+		console.error(`[vinext] File-based metadata resolution failed while rendering error boundary for ${options.routePath}:`, error);
+	}
+	return {
+		hasSearchParams,
+		metadata,
+		pageSearchParams,
+		viewport: mergeViewport(viewportList)
+	};
+}
+//#endregion
+export { collectAppPageSearchParams, resolveActiveParallelRouteHeadInputs, resolveAppPageHead };
+
+//# sourceMappingURL=app-page-head.js.map

package/dist/server/app-page-head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-page-head.js","names":[],"sources":["../../src/server/app-page-head.ts"],"sourcesContent":["import {\n  mergeMetadataEntries,\n  mergeViewport,\n  resolveModuleMetadata,\n  resolveModuleViewport,\n  type Metadata,\n  type MetadataMergeEntry,\n  type Viewport,\n} from \"vinext/shims/metadata\";\nimport { applyFileBasedMetadata } from \"./file-based-metadata.js\";\nimport type { AppPageParams } from \"./app-page-boundary.js\";\nimport { resolveAppPageSegmentParams } from \"./app-page-params.js\";\nimport type { MetadataFileRoute } from \"./metadata-routes.js\";\n\ntype AppPageSearchParams = Record<string, string | string[]>;\n\ntype AppPageHeadModule = Record<string, unknown>;\n\ntype AppPageHeadSource = {\n  metadata: Metadata | null;\n  routeSegments: readonly string[];\n};\n\ntype AppPageHeadLayout<TModule extends AppPageHeadModule> = {\n  module: TModule;\n  treePosition: number;\n};\n\ntype AppPageHeadParallelRoute<TModule extends AppPageHeadModule = AppPageHeadModule> = {\n  layoutModule?: TModule | null;\n  layoutModules?: readonly (TModule | null | undefined)[] | null;\n  pageModule?: TModule | null;\n  params?: AppPageParams | null;\n  routeSegments?: readonly string[] | null;\n};\n\ntype AppPageHeadSlot<TModule extends AppPageHeadModule = AppPageHeadModule> = {\n  layout?: TModule | null;\n  page?: TModule | null;\n};\n\ntype ResolveActiveParallelRouteHeadInputsOptions<\n  TModule extends AppPageHeadModule = AppPageHeadModule,\n> = {\n  interceptLayouts?: readonly (TModule | null | undefined)[] | null;\n  interceptPage?: TModule | null;\n  interceptParams?: AppPageParams | null;\n  interceptSlotKey?: string | null;\n  params: AppPageParams;\n  routeSegments: readonly string[];\n  slots?: Record<string, AppPageHeadSlot<TModule>> | null;\n};\n\ntype ResolveAppPageHeadOptions<TModule extends AppPageHeadModule = AppPageHeadModule> = {\n  fallbackOnFileMetadataError?: boolean;\n  layoutModules: readonly (TModule | null | undefined)[];\n  layoutTreePositions?: readonly number[] | null;\n  metadataRoutes: readonly MetadataFileRoute[];\n  pageModule?: TModule | null;\n  parallelRoutes?: readonly AppPageHeadParallelRoute<TModule>[] | null;\n  params: AppPageParams;\n  routePath: string;\n  routeSegments?: readonly string[] | null;\n  searchParams?: URLSearchParams | null;\n};\n\ntype ResolveAppPageHeadResult = {\n  hasSearchParams: boolean;\n  metadata: Metadata | null;\n  pageSearchParams: AppPageSearchParams;\n  viewport: Viewport;\n};\n\ntype AppPageSearchParamsCollection = {\n  hasSearchParams: boolean;\n  pageSearchParams: AppPageSearchParams;\n};\n\ntype ResolvedParallelRouteHead = {\n  metadataResults: (Metadata | null)[];\n  metadataSources: AppPageHeadSource[];\n  viewportResults: (Viewport | null)[];\n};\n\nexport function resolveActiveParallelRouteHeadInputs<TModule extends AppPageHeadModule>(\n  options: ResolveActiveParallelRouteHeadInputsOptions<TModule>,\n): AppPageHeadParallelRoute<TModule>[] {\n  return Object.entries(options.slots ?? {}).map(([slotKey, slot]) => {\n    if (options.interceptSlotKey === slotKey && options.interceptPage) {\n      return {\n        layoutModules: options.interceptLayouts ?? [],\n        pageModule: options.interceptPage,\n        params: options.interceptParams ?? options.params,\n        routeSegments: options.routeSegments,\n      };\n    }\n\n    return {\n      layoutModules: slot.layout ? [slot.layout] : [],\n      pageModule: slot.page,\n      params: options.params,\n      routeSegments: options.routeSegments,\n    };\n  });\n}\n\nfunction isPresent<T>(value: T | null | undefined): value is T {\n  return value !== null && value !== undefined;\n}\n\nexport function collectAppPageSearchParams(\n  searchParams: URLSearchParams | null | undefined,\n): AppPageSearchParamsCollection {\n  const pageSearchParams: AppPageSearchParams = Object.create(null);\n  let hasSearchParams = false;\n\n  searchParams?.forEach((value, key) => {\n    hasSearchParams = true;\n    const currentValue = pageSearchParams[key];\n    if (Array.isArray(currentValue)) {\n      pageSearchParams[key] = [...currentValue, value];\n      return;\n    }\n    if (currentValue !== undefined) {\n      pageSearchParams[key] = [currentValue, value];\n      return;\n    }\n    pageSearchParams[key] = value;\n  });\n\n  return { hasSearchParams, pageSearchParams };\n}\n\nfunction createMetadataSources(\n  metadataResults: readonly (Metadata | null)[],\n  routeSegments: readonly string[],\n  layoutTreePositions: readonly number[],\n  pageMetadata: Metadata | null,\n  includePageSource: boolean,\n): AppPageHeadSource[] {\n  const metadataSources: AppPageHeadSource[] = metadataResults.map((metadata, index) => ({\n    routeSegments: routeSegments.slice(0, layoutTreePositions[index] ?? 0),\n    metadata,\n  }));\n\n  if (includePageSource) {\n    metadataSources.push({\n      routeSegments,\n      metadata: pageMetadata,\n    });\n  }\n\n  return metadataSources;\n}\n\nfunction createLayoutInputs<TModule extends AppPageHeadModule>(\n  layoutModules: readonly (TModule | null | undefined)[],\n  layoutTreePositions: readonly number[],\n): AppPageHeadLayout<TModule>[] {\n  const layoutInputs: AppPageHeadLayout<TModule>[] = [];\n\n  for (let index = 0; index < layoutModules.length; index++) {\n    const layoutModule = layoutModules[index];\n    if (!isPresent(layoutModule)) {\n      continue;\n    }\n    layoutInputs.push({\n      module: layoutModule,\n      treePosition: layoutTreePositions[index] ?? 0,\n    });\n  }\n\n  return layoutInputs;\n}\n\nasync function resolveLayoutMetadata<TModule extends AppPageHeadModule>(\n  layoutInputs: readonly AppPageHeadLayout<TModule>[],\n  params: AppPageParams,\n  routeSegments: readonly string[],\n): Promise<(Metadata | null)[]> {\n  const layoutMetadataPromises: Promise<Metadata | null>[] = [];\n  let accumulatedMetadata = Promise.resolve<Metadata>({});\n\n  for (const layoutInput of layoutInputs) {\n    const parentForLayout = accumulatedMetadata;\n    const layoutParams = resolveAppPageSegmentParams(\n      routeSegments,\n      layoutInput.treePosition,\n      params,\n    );\n    const metadataPromise = resolveModuleMetadata(\n      layoutInput.module,\n      layoutParams,\n      undefined,\n      parentForLayout,\n    );\n    layoutMetadataPromises.push(metadataPromise);\n    void metadataPromise.catch(() => null);\n\n    accumulatedMetadata = metadataPromise.then(async (metadataResult) => {\n      if (metadataResult) {\n        return mergeMetadataEntries([\n          { metadata: await parentForLayout },\n          { metadata: metadataResult },\n        ]);\n      }\n      return parentForLayout;\n    });\n    void accumulatedMetadata.catch(() => null);\n  }\n\n  return Promise.all(layoutMetadataPromises);\n}\n\nasync function resolveLayoutViewport<TModule extends AppPageHeadModule>(\n  layoutInputs: readonly AppPageHeadLayout<TModule>[],\n  params: AppPageParams,\n  routeSegments: readonly string[],\n): Promise<(Viewport | null)[]> {\n  return Promise.all(\n    layoutInputs.map((layoutInput) => {\n      const layoutParams = resolveAppPageSegmentParams(\n        routeSegments,\n        layoutInput.treePosition,\n        params,\n      );\n      return resolveModuleViewport(layoutInput.module, layoutParams);\n    }),\n  );\n}\n\nasync function resolveParallelRouteHead<TModule extends AppPageHeadModule>(\n  parallelRoute: AppPageHeadParallelRoute<TModule>,\n  fallbackParams: AppPageParams,\n  fallbackRouteSegments: readonly string[],\n  pageSearchParams: AppPageSearchParams,\n  parent: Promise<Metadata>,\n): Promise<ResolvedParallelRouteHead> {\n  const params = parallelRoute.params ?? fallbackParams;\n  const routeSegments = parallelRoute.routeSegments ?? fallbackRouteSegments;\n  const metadataResults: (Metadata | null)[] = [];\n  const viewportResults: (Viewport | null)[] = [];\n  const metadataSources: AppPageHeadSource[] = [];\n  let accumulatedMetadata = parent;\n  const layoutModules = [...(parallelRoute.layoutModules ?? []), parallelRoute.layoutModule].filter(\n    isPresent,\n  );\n  const layoutViewportPromises = layoutModules.map((layoutModule) =>\n    resolveModuleViewport(layoutModule, params),\n  );\n  const pageViewportPromise = parallelRoute.pageModule\n    ? resolveModuleViewport(parallelRoute.pageModule, params)\n    : Promise.resolve(null);\n  for (const layoutViewportPromise of layoutViewportPromises) {\n    void layoutViewportPromise.catch(() => null);\n  }\n  void pageViewportPromise.catch(() => null);\n\n  for (const layoutModule of layoutModules) {\n    const layoutMetadata = await resolveModuleMetadata(\n      layoutModule,\n      params,\n      undefined,\n      accumulatedMetadata,\n    );\n    metadataResults.push(layoutMetadata);\n    // Parallel route metadata sources are scoped to the active slot branch because\n    // the route tree input does not carry per-layout segment positions inside that branch.\n    metadataSources.push({ metadata: layoutMetadata, routeSegments });\n    if (layoutMetadata) {\n      const parentForLayout = accumulatedMetadata;\n      accumulatedMetadata = parentForLayout.then(async (parentMetadata) =>\n        mergeMetadataEntries([{ metadata: parentMetadata }, { metadata: layoutMetadata }]),\n      );\n      void accumulatedMetadata.catch(() => null);\n    }\n  }\n\n  if (parallelRoute.pageModule) {\n    const pageMetadata = await resolveModuleMetadata(\n      parallelRoute.pageModule,\n      params,\n      pageSearchParams,\n      accumulatedMetadata,\n    );\n    metadataResults.push(pageMetadata);\n    // Keep the page source scoped to the same active slot branch as its layouts.\n    metadataSources.push({ metadata: pageMetadata, routeSegments });\n  }\n\n  viewportResults.push(...(await Promise.all(layoutViewportPromises)));\n  const pageViewport = await pageViewportPromise;\n  if (parallelRoute.pageModule) {\n    viewportResults.push(pageViewport);\n  }\n\n  return { metadataResults, metadataSources, viewportResults };\n}\n\nexport async function resolveAppPageHead<TModule extends AppPageHeadModule>(\n  options: ResolveAppPageHeadOptions<TModule>,\n): Promise<ResolveAppPageHeadResult> {\n  const routeSegments = options.routeSegments ?? [];\n  const layoutTreePositions = options.layoutTreePositions ?? [];\n  const layoutInputs = createLayoutInputs(options.layoutModules, layoutTreePositions);\n  const layoutSourcePositions = layoutInputs.map((input) => input.treePosition);\n  const { hasSearchParams, pageSearchParams } = collectAppPageSearchParams(options.searchParams);\n  const layoutMetadataPromise = resolveLayoutMetadata(layoutInputs, options.params, routeSegments);\n  const layoutViewportPromise = resolveLayoutViewport(layoutInputs, options.params, routeSegments);\n\n  const layoutMetadataResultsForParent = layoutMetadataPromise.then((metadataResults) =>\n    metadataResults.filter(isPresent),\n  );\n  void layoutMetadataResultsForParent.catch(() => null);\n  const pageParentPromise = layoutMetadataResultsForParent.then((metadataResults) =>\n    metadataResults.length > 0\n      ? mergeMetadataEntries(metadataResults.map((metadata) => ({ metadata })))\n      : {},\n  );\n  void pageParentPromise.catch(() => null);\n  const pageMetadataPromise = options.pageModule\n    ? resolveModuleMetadata(options.pageModule, options.params, pageSearchParams, pageParentPromise)\n    : Promise.resolve(null);\n  const pageViewportPromise = options.pageModule\n    ? resolveModuleViewport(options.pageModule, options.params)\n    : Promise.resolve(null);\n  const parallelRouteHeadPromise = Promise.all(\n    (options.parallelRoutes ?? []).map((parallelRoute) =>\n      resolveParallelRouteHead(\n        parallelRoute,\n        options.params,\n        routeSegments,\n        pageSearchParams,\n        pageParentPromise,\n      ),\n    ),\n  );\n\n  const [\n    layoutMetadataResults,\n    layoutViewportResults,\n    pageMetadata,\n    pageViewport,\n    parallelRouteHeads,\n  ] = await Promise.all([\n    layoutMetadataPromise,\n    layoutViewportPromise,\n    pageMetadataPromise,\n    pageViewportPromise,\n    parallelRouteHeadPromise,\n  ]);\n  const parallelMetadataResults = parallelRouteHeads.flatMap((head) => head.metadataResults);\n  const parallelViewportResults = parallelRouteHeads.flatMap((head) => head.viewportResults);\n  const parallelMetadataSources = parallelRouteHeads.flatMap((head) => head.metadataSources);\n\n  const metadataEntries: MetadataMergeEntry[] = [\n    ...layoutMetadataResults.filter(isPresent).map((metadata) => ({ metadata })),\n    ...(pageMetadata ? [{ isPage: true, metadata: pageMetadata }] : []),\n    ...parallelMetadataResults\n      .filter(isPresent)\n      .map((metadata) => ({ contributesTitle: false, metadata })),\n  ];\n  const viewportList = [\n    ...layoutViewportResults.filter(isPresent),\n    ...(pageViewport ? [pageViewport] : []),\n    ...parallelViewportResults.filter(isPresent),\n  ];\n\n  const resolvedMetadataBase =\n    metadataEntries.length > 0 ? mergeMetadataEntries(metadataEntries) : null;\n  const metadataSources = createMetadataSources(\n    layoutMetadataResults,\n    routeSegments,\n    layoutSourcePositions,\n    pageMetadata,\n    Boolean(options.pageModule),\n  );\n  metadataSources.push(...parallelMetadataSources);\n  let metadata = resolvedMetadataBase;\n\n  try {\n    metadata = await applyFileBasedMetadata(\n      resolvedMetadataBase,\n      options.routePath,\n      options.params,\n      options.metadataRoutes,\n      {\n        routeSegments,\n        metadataSources,\n      },\n    );\n  } catch (error) {\n    if (!options.fallbackOnFileMetadataError) {\n      throw error;\n    }\n    console.error(\n      `[vinext] File-based metadata resolution failed while rendering error boundary for ${options.routePath}:`,\n      error,\n    );\n  }\n\n  return {\n    hasSearchParams,\n    metadata,\n    pageSearchParams,\n    viewport: mergeViewport(viewportList),\n  };\n}\n"],"mappings":"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"}

package/dist/server/app-page-method.d.ts

@@ -0,0 +1,16 @@
+//#region src/server/app-page-method.d.ts
+type AppPageMethodPolicyOptions = {
+  dynamicConfig?: string;
+  hasGenerateStaticParams: boolean;
+  isDynamicRoute: boolean;
+  revalidateSeconds: number | null;
+};
+type ResolveAppPageMethodResponseOptions = {
+  middlewareHeaders?: Headers | null;
+  request: Pick<Request, "headers" | "method">;
+} & AppPageMethodPolicyOptions;
+declare function isStaticOrSsgAppPageCandidate(options: AppPageMethodPolicyOptions): boolean;
+declare function resolveAppPageMethodResponse(options: ResolveAppPageMethodResponseOptions): Response | null;
+//#endregion
+export { isStaticOrSsgAppPageCandidate, resolveAppPageMethodResponse };
+//# sourceMappingURL=app-page-method.d.ts.map

package/dist/server/app-page-method.js

@@ -0,0 +1,30 @@
+import { mergeMiddlewareResponseHeaders } from "./middleware-response-headers.js";
+import { isPossibleAppRouteActionRequest } from "./app-route-handler-policy.js";
+//#region src/server/app-page-method.ts
+function isNonGetOrHead(method) {
+	const normalizedMethod = method.toUpperCase();
+	return normalizedMethod !== "GET" && normalizedMethod !== "HEAD";
+}
+function isStaticOrSsgAppPageCandidate(options) {
+	if (options.dynamicConfig === "force-dynamic" || options.revalidateSeconds === 0) return false;
+	if (options.dynamicConfig === "force-static" || options.dynamicConfig === "error") return true;
+	if (options.revalidateSeconds !== null && options.revalidateSeconds > 0) return true;
+	if (options.hasGenerateStaticParams) return true;
+	return !options.isDynamicRoute;
+}
+function resolveAppPageMethodResponse(options) {
+	if (!isNonGetOrHead(options.request.method)) return null;
+	if (isPossibleAppRouteActionRequest(options.request)) return null;
+	if (!isStaticOrSsgAppPageCandidate(options)) return null;
+	const headers = new Headers();
+	mergeMiddlewareResponseHeaders(headers, options.middlewareHeaders ?? null);
+	headers.set("Allow", "GET, HEAD");
+	return new Response("Method Not Allowed", {
+		headers,
+		status: 405
+	});
+}
+//#endregion
+export { isStaticOrSsgAppPageCandidate, resolveAppPageMethodResponse };
+
+//# sourceMappingURL=app-page-method.js.map

package/dist/server/app-page-method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-page-method.js","names":[],"sources":["../../src/server/app-page-method.ts"],"sourcesContent":["import { isPossibleAppRouteActionRequest } from \"./app-route-handler-policy.js\";\nimport { mergeMiddlewareResponseHeaders } from \"./middleware-response-headers.js\";\n\ntype AppPageMethodPolicyOptions = {\n  dynamicConfig?: string;\n  hasGenerateStaticParams: boolean;\n  isDynamicRoute: boolean;\n  revalidateSeconds: number | null;\n};\n\ntype ResolveAppPageMethodResponseOptions = {\n  middlewareHeaders?: Headers | null;\n  request: Pick<Request, \"headers\" | \"method\">;\n} & AppPageMethodPolicyOptions;\n\nfunction isNonGetOrHead(method: string): boolean {\n  const normalizedMethod = method.toUpperCase();\n  return normalizedMethod !== \"GET\" && normalizedMethod !== \"HEAD\";\n}\n\nexport function isStaticOrSsgAppPageCandidate(options: AppPageMethodPolicyOptions): boolean {\n  if (options.dynamicConfig === \"force-dynamic\" || options.revalidateSeconds === 0) {\n    return false;\n  }\n\n  if (options.dynamicConfig === \"force-static\" || options.dynamicConfig === \"error\") {\n    return true;\n  }\n\n  if (options.revalidateSeconds !== null && options.revalidateSeconds > 0) {\n    return true;\n  }\n\n  if (options.hasGenerateStaticParams) {\n    return true;\n  }\n\n  return !options.isDynamicRoute;\n}\n\nexport function resolveAppPageMethodResponse(\n  options: ResolveAppPageMethodResponseOptions,\n): Response | null {\n  if (!isNonGetOrHead(options.request.method)) {\n    return null;\n  }\n\n  if (isPossibleAppRouteActionRequest(options.request)) {\n    return null;\n  }\n\n  if (!isStaticOrSsgAppPageCandidate(options)) {\n    return null;\n  }\n\n  const headers = new Headers();\n  mergeMiddlewareResponseHeaders(headers, options.middlewareHeaders ?? null);\n  headers.set(\"Allow\", \"GET, HEAD\");\n\n  return new Response(\"Method Not Allowed\", {\n    headers,\n    status: 405,\n  });\n}\n"],"mappings":";;;AAeA,SAAS,eAAe,QAAyB;CAC/C,MAAM,mBAAmB,OAAO,aAAa;AAC7C,QAAO,qBAAqB,SAAS,qBAAqB;;AAG5D,SAAgB,8BAA8B,SAA8C;AAC1F,KAAI,QAAQ,kBAAkB,mBAAmB,QAAQ,sBAAsB,EAC7E,QAAO;AAGT,KAAI,QAAQ,kBAAkB,kBAAkB,QAAQ,kBAAkB,QACxE,QAAO;AAGT,KAAI,QAAQ,sBAAsB,QAAQ,QAAQ,oBAAoB,EACpE,QAAO;AAGT,KAAI,QAAQ,wBACV,QAAO;AAGT,QAAO,CAAC,QAAQ;;AAGlB,SAAgB,6BACd,SACiB;AACjB,KAAI,CAAC,eAAe,QAAQ,QAAQ,OAAO,CACzC,QAAO;AAGT,KAAI,gCAAgC,QAAQ,QAAQ,CAClD,QAAO;AAGT,KAAI,CAAC,8BAA8B,QAAQ,CACzC,QAAO;CAGT,MAAM,UAAU,IAAI,SAAS;AAC7B,gCAA+B,SAAS,QAAQ,qBAAqB,KAAK;AAC1E,SAAQ,IAAI,SAAS,YAAY;AAEjC,QAAO,IAAI,SAAS,sBAAsB;EACxC;EACA,QAAQ;EACT,CAAC"}

package/dist/server/app-page-params.d.ts

@@ -0,0 +1,7 @@
+import { AppPageParams } from "./app-page-boundary.js";
+
+//#region src/server/app-page-params.d.ts
+declare function resolveAppPageSegmentParams(routeSegments: readonly string[] | null | undefined, treePosition: number, matchedParams: AppPageParams): AppPageParams;
+//#endregion
+export { resolveAppPageSegmentParams };
+//# sourceMappingURL=app-page-params.d.ts.map

package/dist/server/app-page-params.js

@@ -0,0 +1,28 @@
+//#region src/server/app-page-params.ts
+function getSegmentParamName(segment) {
+	if (segment.startsWith("[[...") && segment.endsWith("]]") && segment.length > 7) return segment.slice(5, -2);
+	if (segment.startsWith("[...") && segment.endsWith("]") && segment.length > 5) return segment.slice(4, -1);
+	if (segment.startsWith("[") && segment.endsWith("]") && !segment.includes(".") && segment.length > 2) return segment.slice(1, -1);
+	return null;
+}
+function isEmptyOptionalCatchAll(segment, paramValue) {
+	return segment.startsWith("[[...") && Array.isArray(paramValue) && paramValue.length === 0;
+}
+function resolveAppPageSegmentParams(routeSegments, treePosition, matchedParams) {
+	const segmentParams = {};
+	const segments = routeSegments ?? [];
+	const end = Math.min(Math.max(treePosition, 0), segments.length);
+	for (let index = 0; index < end; index++) {
+		const segment = segments[index];
+		const paramName = getSegmentParamName(segment);
+		if (!paramName) continue;
+		const paramValue = matchedParams[paramName];
+		if (paramValue === void 0 || isEmptyOptionalCatchAll(segment, paramValue)) continue;
+		segmentParams[paramName] = paramValue;
+	}
+	return segmentParams;
+}
+//#endregion
+export { resolveAppPageSegmentParams };
+
+//# sourceMappingURL=app-page-params.js.map

package/dist/server/app-page-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-page-params.js","names":[],"sources":["../../src/server/app-page-params.ts"],"sourcesContent":["import type { AppPageParams } from \"./app-page-boundary.js\";\n\nfunction getSegmentParamName(segment: string): string | null {\n  if (segment.startsWith(\"[[...\") && segment.endsWith(\"]]\") && segment.length > 7) {\n    return segment.slice(5, -2);\n  }\n\n  if (segment.startsWith(\"[...\") && segment.endsWith(\"]\") && segment.length > 5) {\n    return segment.slice(4, -1);\n  }\n\n  if (\n    segment.startsWith(\"[\") &&\n    segment.endsWith(\"]\") &&\n    !segment.includes(\".\") &&\n    segment.length > 2\n  ) {\n    return segment.slice(1, -1);\n  }\n\n  return null;\n}\n\nfunction isEmptyOptionalCatchAll(segment: string, paramValue: string | string[]): boolean {\n  return segment.startsWith(\"[[...\") && Array.isArray(paramValue) && paramValue.length === 0;\n}\n\nexport function resolveAppPageSegmentParams(\n  routeSegments: readonly string[] | null | undefined,\n  treePosition: number,\n  matchedParams: AppPageParams,\n): AppPageParams {\n  const segmentParams: AppPageParams = {};\n  const segments = routeSegments ?? [];\n  const end = Math.min(Math.max(treePosition, 0), segments.length);\n\n  for (let index = 0; index < end; index++) {\n    const segment = segments[index];\n    const paramName = getSegmentParamName(segment);\n    if (!paramName) {\n      continue;\n    }\n\n    const paramValue = matchedParams[paramName];\n    if (paramValue === undefined || isEmptyOptionalCatchAll(segment, paramValue)) {\n      continue;\n    }\n\n    segmentParams[paramName] = paramValue;\n  }\n\n  return segmentParams;\n}\n"],"mappings":";AAEA,SAAS,oBAAoB,SAAgC;AAC3D,KAAI,QAAQ,WAAW,QAAQ,IAAI,QAAQ,SAAS,KAAK,IAAI,QAAQ,SAAS,EAC5E,QAAO,QAAQ,MAAM,GAAG,GAAG;AAG7B,KAAI,QAAQ,WAAW,OAAO,IAAI,QAAQ,SAAS,IAAI,IAAI,QAAQ,SAAS,EAC1E,QAAO,QAAQ,MAAM,GAAG,GAAG;AAG7B,KACE,QAAQ,WAAW,IAAI,IACvB,QAAQ,SAAS,IAAI,IACrB,CAAC,QAAQ,SAAS,IAAI,IACtB,QAAQ,SAAS,EAEjB,QAAO,QAAQ,MAAM,GAAG,GAAG;AAG7B,QAAO;;AAGT,SAAS,wBAAwB,SAAiB,YAAwC;AACxF,QAAO,QAAQ,WAAW,QAAQ,IAAI,MAAM,QAAQ,WAAW,IAAI,WAAW,WAAW;;AAG3F,SAAgB,4BACd,eACA,cACA,eACe;CACf,MAAM,gBAA+B,EAAE;CACvC,MAAM,WAAW,iBAAiB,EAAE;CACpC,MAAM,MAAM,KAAK,IAAI,KAAK,IAAI,cAAc,EAAE,EAAE,SAAS,OAAO;AAEhE,MAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,SAAS;EACxC,MAAM,UAAU,SAAS;EACzB,MAAM,YAAY,oBAAoB,QAAQ;AAC9C,MAAI,CAAC,UACH;EAGF,MAAM,aAAa,cAAc;AACjC,MAAI,eAAe,KAAA,KAAa,wBAAwB,SAAS,WAAW,CAC1E;AAGF,gBAAc,aAAa;;AAG7B,QAAO"}