vinext 1.0.0-beta.8 → 1.0.0

package/dist/client/app-nav-failure-handler.d.ts

@@ -1,8 +1,7 @@
 //#region src/client/app-nav-failure-handler.d.ts
-declare function stageAppNavigationFailureTarget(href: string): void;
-declare function getAppNavigationFailureTarget(href: string): URL | null;
-declare function clearAppNavigationFailureTarget(target?: string | URL): void;
-declare function handleAppNavigationFailure(error: unknown): boolean;
-declare function installAppNavigationFailureListeners(): () => void;
-//#endregion
-export { clearAppNavigationFailureTarget, getAppNavigationFailureTarget, handleAppNavigationFailure, installAppNavigationFailureListeners, stageAppNavigationFailureTarget };
+export declare function stageAppNavigationFailureTarget(href: string): void;
+export declare function getAppNavigationFailureTarget(href: string): URL | null;
+export declare function clearAppNavigationFailureTarget(target?: string | URL): void;
+export declare function handleAppNavigationFailure(error: unknown): boolean;
+export declare function installAppNavigationFailureListeners(): () => void;
+//#endregion

package/dist/client/client-rewrite-matcher.d.ts

@@ -2,11 +2,10 @@ import { RequestContext } from "../config/request-context.js";
 import { BasePathMatchState } from "../config/config-matchers.js";
 import { ClientRewrite } from "./client-rewrites.js";
 //#region src/client/client-rewrite-matcher.d.ts
-declare function matchClientRewrite(pathname: string, rewrite: ClientRewrite, context: RequestContext, basePathState: BasePathMatchState): {
+export declare function matchClientRewrite(pathname: string, rewrite: ClientRewrite, context: RequestContext, basePathState: BasePathMatchState): {
   kind: "rewrite";
   destination: string;
 } | {
   kind: "server";
 } | null;
-//#endregion
-export { matchClientRewrite };
+//#endregion

package/dist/client/client-rewrites.d.ts

@@ -14,18 +14,17 @@ type ClientRewriteFields = Pick<NextRewrite, "basePath" | "locale" | "source"> &
  * use browser-authoritative conditions as a prefilter before handing the
  * navigation to the server.
  */
-type ClientRewrite = (ClientRewriteFields & {
+export type ClientRewrite = (ClientRewriteFields & {
   destination: string;
   requiresServerEvaluation?: never;
 }) | (ClientRewriteFields & {
   destination?: never;
   requiresServerEvaluation: true;
 });
-type ClientRewrites = {
+export type ClientRewrites = {
   afterFiles: ClientRewrite[];
   beforeFiles: ClientRewrite[];
   fallback: ClientRewrite[];
 };
-declare function toClientRewrites(rewrites: ResolvedNextConfig["rewrites"]): ClientRewrites;
-//#endregion
-export { ClientRewrite, ClientRewrites, toClientRewrites };
+export declare function toClientRewrites(rewrites: ResolvedNextConfig["rewrites"]): ClientRewrites;
+//#endregion

package/dist/client/dev-error-overlay-store.d.ts

@@ -1,6 +1,6 @@
 //#region src/client/dev-error-overlay-store.d.ts
-type Source = "server" | "vite" | "uncaught" | "caught" | "window-error" | "unhandledrejection";
-type ReportedError = {
+export type Source = "server" | "vite" | "uncaught" | "caught" | "window-error" | "unhandledrejection";
+export type ReportedError = {
   id: number;
   source: Source;
   message: string;
@@ -10,7 +10,7 @@ type ReportedError = {
   codeFrame: OverlayCodeFrame | undefined;
   componentStack: string | undefined;
 };
-type OverlayCodeFrame = {
+export type OverlayCodeFrame = {
   file: string;
   line: number;
   column: number;
@@ -22,18 +22,17 @@ type OverlayCodeFrameLine = {
   text: string;
   isErrorLine: boolean;
 };
-type OverlayState = {
+export type OverlayState = {
   errors: ReportedError[];
   index: number;
   minimized: boolean;
 };
-declare function subscribeOverlay(fn: () => void): () => void;
-declare function getOverlaySnapshot(): OverlayState;
-declare function reportToOverlay(error: Omit<ReportedError, "id">): number;
-declare function updateOverlayErrorStack(id: number, stack: string | undefined, ignoredStackFrames?: boolean[], codeFrame?: OverlayCodeFrame, projectRoot?: string): void;
-declare function dismissOverlay(): void;
-declare function setOverlayIndex(index: number): void;
-declare function minimizeOverlay(): void;
-declare function expandOverlay(): void;
-//#endregion
-export { OverlayCodeFrame, OverlayState, ReportedError, Source, dismissOverlay, expandOverlay, getOverlaySnapshot, minimizeOverlay, reportToOverlay, setOverlayIndex, subscribeOverlay, updateOverlayErrorStack };
+export declare function subscribeOverlay(fn: () => void): () => void;
+export declare function getOverlaySnapshot(): OverlayState;
+export declare function reportToOverlay(error: Omit<ReportedError, "id">): number;
+export declare function updateOverlayErrorStack(id: number, stack: string | undefined, ignoredStackFrames?: boolean[], codeFrame?: OverlayCodeFrame, projectRoot?: string): void;
+export declare function dismissOverlay(): void;
+export declare function setOverlayIndex(index: number): void;
+export declare function minimizeOverlay(): void;
+export declare function expandOverlay(): void;
+//#endregion

package/dist/client/dev-error-overlay.d.ts

@@ -1,10 +1,10 @@
 import { ReportedError, dismissOverlay } from "./dev-error-overlay-store.js";
 //#region src/client/dev-error-overlay.d.ts
-declare const DEV_ERROR_OVERLAY_HOST_ID = "__vinext_dev_error_overlay_root";
-declare const DEV_ERROR_OVERLAY_MOUNT_ID = "__vinext_dev_error_overlay_mount";
-declare function installDevErrorOverlay(): void;
-declare function installReactRefreshErrorRecovery(): void;
-declare function reportInitialDevServerErrors(): void;
+export declare const DEV_ERROR_OVERLAY_HOST_ID = "__vinext_dev_error_overlay_root";
+export declare const DEV_ERROR_OVERLAY_MOUNT_ID = "__vinext_dev_error_overlay_mount";
+export declare function installDevErrorOverlay(): void;
+export declare function installReactRefreshErrorRecovery(): void;
+export declare function reportInitialDevServerErrors(): void;
 type ViteHmrErrorPayload = {
   err?: ViteHmrError;
 };
@@ -17,17 +17,17 @@ type ViteHmrError = {
 type NormalizedViteHmrError = {
   message: string;
 };
-declare function installViteHmrErrorHandler(hot: unknown): void;
-declare function normalizeViteHmrError(payload: ViteHmrErrorPayload): NormalizedViteHmrError;
-declare function devOnCaughtError(error: unknown, errorInfo: {
+export declare function installViteHmrErrorHandler(hot: unknown): void;
+export declare function normalizeViteHmrError(payload: ViteHmrErrorPayload): NormalizedViteHmrError;
+export declare function devOnCaughtError(error: unknown, errorInfo: {
   componentStack?: string;
   errorBoundary?: unknown;
 }): void;
-declare function devOnUncaughtError(error: unknown, errorInfo: {
+export declare function devOnUncaughtError(error: unknown, errorInfo: {
   componentStack?: string;
   errorBoundary?: unknown;
 }): void;
-declare function createDevErrorOverlayMountNode(ownerDocument: Document): HTMLElement;
+export declare function createDevErrorOverlayMountNode(ownerDocument: Document): HTMLElement;
 type FrameLocation = {
   file?: string;
   line?: string;
@@ -42,9 +42,9 @@ type ClipboardStackFrame = {
   ignored?: boolean;
 };
 type ClipboardErrorInfo = Pick<ReportedError, "source" | "message"> & Partial<Pick<ReportedError, "projectRoot" | "codeFrame" | "componentStack">>;
-declare function formatOverlayDisplayFile(file: string, projectRoot?: string): string;
-declare function formatErrorInfoForClipboard(error: ClipboardErrorInfo, frames: readonly ClipboardStackFrame[]): string;
-declare function formatViteOpenInEditorFile(frame: FrameLocation): string | null;
-declare function createViteOpenInEditorUrl(file: string, baseUrl?: string): string;
+export declare function formatOverlayDisplayFile(file: string, projectRoot?: string): string;
+export declare function formatErrorInfoForClipboard(error: ClipboardErrorInfo, frames: readonly ClipboardStackFrame[]): string;
+export declare function formatViteOpenInEditorFile(frame: FrameLocation): string | null;
+export declare function createViteOpenInEditorUrl(file: string, baseUrl?: string): string;
 //#endregion
-export { DEV_ERROR_OVERLAY_HOST_ID, DEV_ERROR_OVERLAY_MOUNT_ID, createDevErrorOverlayMountNode, createViteOpenInEditorUrl, devOnCaughtError, devOnUncaughtError, dismissOverlay, formatErrorInfoForClipboard, formatOverlayDisplayFile, formatViteOpenInEditorFile, installDevErrorOverlay, installReactRefreshErrorRecovery, installViteHmrErrorHandler, normalizeViteHmrError, reportInitialDevServerErrors };
+export { dismissOverlay };

package/dist/client/dev-error-overlay.js

@@ -1,5 +1,5 @@
-import { VINEXT_DEV_ERROR_RECOVERY_EVENT } from "../utils/dev-error-recovery-event.js";
 import { isNavigationSignalError } from "../utils/navigation-signal.js";
+import { VINEXT_DEV_ERROR_RECOVERY_EVENT } from "../utils/dev-error-recovery-event.js";
 import { VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT } from "../utils/dev-stack-sourcemap-endpoint.js";
 import { dismissOverlay, expandOverlay, getOverlaySnapshot, minimizeOverlay, reportToOverlay, setOverlayIndex, subscribeOverlay, updateOverlayErrorStack } from "./dev-error-overlay-store.js";
 import { Fragment, useEffect, useMemo, useState, useSyncExternalStore } from "react";
@@ -176,7 +176,8 @@ function stringValue(value) {
 }
 function ensureMounted() {
 	if (reactRoot) return;
-	reactRoot = createRoot(createDevErrorOverlayMountNode(document));
+	const node = createDevErrorOverlayMountNode(document);
+	reactRoot = createRoot(node);
 	reactRoot.render(/* @__PURE__ */ jsx(DevErrorOverlayApp, {}));
 }
 function createDevErrorOverlayMountNode(ownerDocument) {
@@ -263,12 +264,14 @@ function DevErrorOverlay({ error, index, total, onPrev, onNext, onMinimize, onDi
 		error.projectRoot,
 		isBuildError
 	]);
+	const [previousErrorId, setPreviousErrorId] = useState(error.id);
 	const [showIgnoredFrames, setShowIgnoredFrames] = useState(false);
+	if (previousErrorId !== error.id) {
+		setPreviousErrorId(error.id);
+		setShowIgnoredFrames(false);
+	}
 	const ignoredFramesTally = frames.some((frame) => !frame.ignored) ? frames.reduce((tally, frame) => tally + (frame.ignored ? 1 : 0), 0) : 0;
 	const visibleFrames = showIgnoredFrames || ignoredFramesTally === 0 ? frames : frames.filter((frame) => !frame.ignored);
-	useEffect(() => {
-		setShowIgnoredFrames(false);
-	}, [error.id]);
 	useEffect(() => {
 		const onKey = (e) => {
 			if (e.key === "Escape") onMinimize();

package/dist/client/instrumentation-client-inject.d.ts

@@ -1,6 +1,6 @@
 //#region src/client/instrumentation-client-inject.d.ts
 /** Absolute path to the vinext empty-module fallback for composed client instrumentation. */
-declare const INSTRUMENTATION_CLIENT_EMPTY_MODULE: string;
+export declare const INSTRUMENTATION_CLIENT_EMPTY_MODULE: string;
 /**
  * Generate a virtual ESM module that implements the Next.js
  * `instrumentationClientInject` contract for client bootstrap.
@@ -28,6 +28,5 @@ declare const INSTRUMENTATION_CLIENT_EMPTY_MODULE: string;
  *                   or `null` when the file doesn't exist
  * @param emptyModulePath - Absolute path to the empty-module fallback
  */
-declare function generateInstrumentationClientInjectModule(injects: readonly string[], userPath: string | null, emptyModulePath?: string): string;
-//#endregion
-export { INSTRUMENTATION_CLIENT_EMPTY_MODULE, generateInstrumentationClientInjectModule };
+export declare function generateInstrumentationClientInjectModule(injects: readonly string[], userPath: string | null, emptyModulePath?: string): string;
+//#endregion

package/dist/client/instrumentation-client-state.d.ts

@@ -1,8 +1,7 @@
 import { ClientInstrumentationHooks } from "./instrumentation-client.js";
 //#region src/client/instrumentation-client-state.d.ts
-declare function normalizeClientInstrumentationHooks(hooks: ClientInstrumentationHooks): ClientInstrumentationHooks | null;
-declare function setClientInstrumentationHooks(hooks: ClientInstrumentationHooks | null): ClientInstrumentationHooks | null;
-declare function getClientInstrumentationHooks(): ClientInstrumentationHooks | null;
-declare function notifyAppRouterTransitionStart(href: string, navigationType: "push" | "replace" | "traverse"): void;
-//#endregion
-export { getClientInstrumentationHooks, normalizeClientInstrumentationHooks, notifyAppRouterTransitionStart, setClientInstrumentationHooks };
+export declare function normalizeClientInstrumentationHooks(hooks: ClientInstrumentationHooks): ClientInstrumentationHooks | null;
+export declare function setClientInstrumentationHooks(hooks: ClientInstrumentationHooks | null): ClientInstrumentationHooks | null;
+export declare function getClientInstrumentationHooks(): ClientInstrumentationHooks | null;
+export declare function notifyAppRouterTransitionStart(href: string, navigationType: "push" | "replace" | "traverse"): void;
+//#endregion

package/dist/client/instrumentation-client.d.ts

@@ -1,7 +1,6 @@
 //#region src/client/instrumentation-client.d.ts
-type ClientInstrumentationHooks = {
+export type ClientInstrumentationHooks = {
   onRouterTransitionStart?: (href: string, navigationType: "push" | "replace" | "traverse") => void;
 };
-declare const clientInstrumentationHooks: ClientInstrumentationHooks | null;
-//#endregion
-export { ClientInstrumentationHooks, clientInstrumentationHooks };
+export declare const clientInstrumentationHooks: ClientInstrumentationHooks | null;
+//#endregion

package/dist/client/navigation-runtime.d.ts

@@ -5,14 +5,19 @@ type NavigationRuntimeSnapshot = {
   pathname: string;
   searchParams: [string, string][];
 };
-type NavigationRuntimeRscChunk = string | [3, string];
-type NavigationRuntimeRscBootstrap = {
+export type NavigationRuntimeRscChunk = string | [3, string];
+export type NavigationRuntimeRscBootstrap = {
   done?: boolean;
   dynamicStaleTimeSeconds?: number;
   initialCacheKind?: "dynamic" | "static";
   searchParamsFromBrowser?: boolean;
   nav?: NavigationRuntimeSnapshot;
   params?: Record<string, string | string[]>;
+  /**
+   * The query SSR rendered client pages with, sent after the head when the
+   * render turned dynamic too late for `nav` to carry it.
+   */
+  renderedSearch?: string;
   rsc: NavigationRuntimeRscChunk[];
   /**
    * Client reuse bound in seconds resolved from the initial render's completed
@@ -23,7 +28,7 @@ type NavigationRuntimeRscBootstrap = {
 };
 type NavigationRuntimeKind = "navigate" | "traverse" | "refresh";
 type NavigationRuntimeHistoryUpdateMode = "push" | "replace";
-type NavigationRuntimeVisibleCommitMode = "transition" | "synchronous";
+export type NavigationRuntimeVisibleCommitMode = "transition" | "synchronous";
 type NavigationRuntimePrefetchRouterState = {
   pathAndSearch: string;
   routeId: string;
@@ -33,8 +38,8 @@ type NavigationRuntimeTraversalIntent = {
   historyState: unknown;
   targetHistoryIndex: number | null;
 };
-type NavigationRuntimeNavigate = (href: string, redirectDepth?: number, navigationKind?: NavigationRuntimeKind, historyUpdateMode?: NavigationRuntimeHistoryUpdateMode, previousNextUrlOverride?: string | null, programmaticTransition?: boolean, traversalIntent?: NavigationRuntimeTraversalIntent, scrollIntent?: AppRouterScrollIntent | null, visibleCommitMode?: NavigationRuntimeVisibleCommitMode, bypassNavigationCache?: boolean) => Promise<void>;
-type NavigationRuntimeFunctions = {
+export type NavigationRuntimeNavigate = (href: string, redirectDepth?: number, navigationKind?: NavigationRuntimeKind, historyUpdateMode?: NavigationRuntimeHistoryUpdateMode, previousNextUrlOverride?: string | null, programmaticTransition?: boolean, traversalIntent?: NavigationRuntimeTraversalIntent, scrollIntent?: AppRouterScrollIntent | null, visibleCommitMode?: NavigationRuntimeVisibleCommitMode, bypassNavigationCache?: boolean) => Promise<void>;
+export type NavigationRuntimeFunctions = {
   clearNavigationCaches?: () => void;
   commitHashNavigation?: (href: string, historyUpdateMode: NavigationRuntimeHistoryUpdateMode, scroll: boolean) => void;
   navigateExternal?: (href: string, historyUpdateMode: NavigationRuntimeHistoryUpdateMode) => Promise<void>;
@@ -53,21 +58,21 @@ type NavigationRuntimeFunctions = {
   claimCurrentHistoryTreeSnapshot?: (historyUpdateMode: NavigationRuntimeHistoryUpdateMode, previousHistoryState: unknown) => void;
   commitAppOwnedHistoryStateWrite?: (historyUpdateMode: NavigationRuntimeHistoryUpdateMode, previousHistoryState: unknown) => void;
 };
-type NavigationRuntimeBootstrap = {
+export type NavigationRuntimeBootstrap = {
   routeManifest: RouteManifest | null;
   rsc: NavigationRuntimeRscBootstrap | undefined;
 };
-type NavigationRuntime = {
+export type NavigationRuntime = {
   bootstrap: NavigationRuntimeBootstrap;
   functions: NavigationRuntimeFunctions;
 };
-declare const NAVIGATION_RUNTIME_SYMBOL_DESCRIPTION = "vinext.navigationRuntime";
-declare const NAVIGATION_RUNTIME_KEY: unique symbol;
-declare function getNavigationRuntime(): NavigationRuntime | null;
-declare function registerNavigationRuntimeBootstrap(bootstrap: Partial<NavigationRuntimeBootstrap>): NavigationRuntime;
-declare function registerNavigationRuntimeFunctions(functions: Partial<NavigationRuntimeFunctions>): NavigationRuntime;
-declare function ensureNavigationRuntimeRscBootstrap(): NavigationRuntimeRscBootstrap;
-declare function hasAppNavigationRuntime(): boolean;
+export declare const NAVIGATION_RUNTIME_SYMBOL_DESCRIPTION = "vinext.navigationRuntime";
+export declare const NAVIGATION_RUNTIME_KEY: unique symbol;
+export declare function getNavigationRuntime(): NavigationRuntime | null;
+export declare function registerNavigationRuntimeBootstrap(bootstrap: Partial<NavigationRuntimeBootstrap>): NavigationRuntime;
+export declare function registerNavigationRuntimeFunctions(functions: Partial<NavigationRuntimeFunctions>): NavigationRuntime;
+export declare function ensureNavigationRuntimeRscBootstrap(): NavigationRuntimeRscBootstrap;
+export declare function hasAppNavigationRuntime(): boolean;
 /**
  * True when the App Router has installed its runtime bootstrap on `window`,
  * which the inline runtime-metadata script does synchronously in `<head>`.
@@ -80,6 +85,5 @@ declare function hasAppNavigationRuntime(): boolean;
  * server-side pre-head splice already emitted the inline beforeInteractive
  * tag) should call this instead.
  */
-declare function hasAppNavigationRuntimeBootstrap(): boolean;
-//#endregion
-export { NAVIGATION_RUNTIME_KEY, NAVIGATION_RUNTIME_SYMBOL_DESCRIPTION, NavigationRuntime, NavigationRuntimeBootstrap, NavigationRuntimeFunctions, NavigationRuntimeNavigate, NavigationRuntimeRscBootstrap, NavigationRuntimeRscChunk, NavigationRuntimeVisibleCommitMode, ensureNavigationRuntimeRscBootstrap, getNavigationRuntime, hasAppNavigationRuntime, hasAppNavigationRuntimeBootstrap, registerNavigationRuntimeBootstrap, registerNavigationRuntimeFunctions };
+export declare function hasAppNavigationRuntimeBootstrap(): boolean;
+//#endregion

package/dist/client/navigation-runtime.js

@@ -55,9 +55,10 @@ function isNavigationRuntimeRscBootstrap(value) {
 	const searchParamsFromBrowser = Reflect.get(value, "searchParamsFromBrowser");
 	const nav = Reflect.get(value, "nav");
 	const params = Reflect.get(value, "params");
+	const renderedSearch = Reflect.get(value, "renderedSearch");
 	const rsc = Reflect.get(value, "rsc");
 	const staleTimeSeconds = Reflect.get(value, "staleTimeSeconds");
-	return (done === void 0 || typeof done === "boolean") && isOptionalStaleTimeSeconds(dynamicStaleTimeSeconds) && (initialCacheKind === void 0 || initialCacheKind === "dynamic" || initialCacheKind === "static") && (searchParamsFromBrowser === void 0 || typeof searchParamsFromBrowser === "boolean") && (nav === void 0 || isNavigationRuntimeSnapshot(nav)) && (params === void 0 || isNavigationRuntimeParams(params)) && Array.isArray(rsc) && rsc.every(isNavigationRuntimeRscChunk) && isOptionalStaleTimeSeconds(staleTimeSeconds);
+	return (done === void 0 || typeof done === "boolean") && isOptionalStaleTimeSeconds(dynamicStaleTimeSeconds) && (initialCacheKind === void 0 || initialCacheKind === "dynamic" || initialCacheKind === "static") && (searchParamsFromBrowser === void 0 || typeof searchParamsFromBrowser === "boolean") && (nav === void 0 || isNavigationRuntimeSnapshot(nav)) && (params === void 0 || isNavigationRuntimeParams(params)) && (renderedSearch === void 0 || typeof renderedSearch === "string") && Array.isArray(rsc) && rsc.every(isNavigationRuntimeRscChunk) && isOptionalStaleTimeSeconds(staleTimeSeconds);
 }
 function isOptionalStaleTimeSeconds(value) {
 	return value === void 0 || typeof value === "number" && Number.isFinite(value) && value >= 0;

package/dist/client/pages-router-link-navigation.d.ts

@@ -26,18 +26,17 @@ type PagesRouterLinkNavigation = {
   locale?: string | false;
   interpolateDynamicRoute?: boolean;
 };
-declare function resolvePagesRouterQueryOnlyHref(href: string, { asPath, basePath, fallbackHref, locales }: {
+export declare function resolvePagesRouterQueryOnlyHref(href: string, { asPath, basePath, fallbackHref, locales }: {
   asPath?: string;
   basePath: string;
   fallbackHref: string;
   locales?: readonly string[];
 }): string;
-declare function navigatePagesRouterLink(router: PagesRouterLinkRuntime, { href, as, replace, scroll, shallow, locale, interpolateDynamicRoute }: PagesRouterLinkNavigation): Promise<void>;
-declare function navigatePagesRouterLinkWithFallback({ router, loadRouter, navigation, fallback }: {
+export declare function navigatePagesRouterLink(router: PagesRouterLinkRuntime, { href, as, replace, scroll, shallow, locale, interpolateDynamicRoute }: PagesRouterLinkNavigation): Promise<void>;
+export declare function navigatePagesRouterLinkWithFallback({ router, loadRouter, navigation, fallback }: {
   router?: PagesRouterLinkRuntime;
   loadRouter: () => Promise<PagesRouterLinkRuntime | undefined>;
   navigation: PagesRouterLinkNavigation;
   fallback: () => void;
 }): Promise<void>;
-//#endregion
-export { navigatePagesRouterLink, navigatePagesRouterLinkWithFallback, resolvePagesRouterQueryOnlyHref };
+//#endregion

package/dist/client/react-instance.d.ts

@@ -8,6 +8,5 @@
  * Server and RSC environments always keep their condition-specific React
  * instance local.
  */
-declare function getVinextReact(reactInstance: typeof import("react")): typeof import("react");
-//#endregion
-export { getVinextReact };
+export declare function getVinextReact(reactInstance: typeof import("react")): typeof import("react");
+//#endregion

package/dist/client/validate-module-path.d.ts

@@ -12,6 +12,5 @@
  * - Protocol-relative URLs (`//...`)
  * - Directory traversal (`..`)
  */
-declare function isValidModulePath(p: unknown): p is string;
-//#endregion
-export { isValidModulePath };
+export declare function isValidModulePath(p: unknown): p is string;
+//#endregion

package/dist/client/vinext-next-data.d.ts

@@ -1,6 +1,6 @@
 import { NEXT_DATA } from "../shims/internal/utils.js";
 //#region src/client/vinext-next-data.d.ts
-type VinextLinkPrefetchRoute = {
+export type VinextLinkPrefetchRoute = {
   canPrefetchLoadingShell: boolean;
   documentOnly?: boolean;
   isDynamic: boolean;
@@ -19,14 +19,14 @@ type VinextLinkPrefetchRoute = {
  * does not have a separate loading boundary and its prefetch surface is
  * `_next/data/<buildId>/<page>.json`.
  */
-type VinextPagesLinkPrefetchRoute = {
+export type VinextPagesLinkPrefetchRoute = {
   canPrefetchLoadingShell: false;
   documentOnly?: boolean;
   isDynamic: boolean;
   patternParts: string[];
   requiresDynamicNavigationRequest?: boolean;
 };
-type VinextNextData = {
+export type VinextNextData = {
   /** vinext-specific additions (not part of Next.js upstream). */
   __vinext?: {
     /** Absolute URL of the page module for dynamic import. */
@@ -47,8 +47,7 @@ type VinextLocaleGlobalTarget = {
   __VINEXT_LOCALES__: string[] | undefined;
   __VINEXT_DEFAULT_LOCALE__: string | undefined;
 };
-declare function extractVinextNextDataJson(html: string): string | null;
-declare function parseVinextNextDataJson(json: string): BrowserVinextNextData;
-declare function applyVinextLocaleGlobals(target: VinextLocaleGlobalTarget, nextData: VinextNextData): void;
-//#endregion
-export { VinextLinkPrefetchRoute, VinextNextData, VinextPagesLinkPrefetchRoute, applyVinextLocaleGlobals, extractVinextNextDataJson, parseVinextNextDataJson };
+export declare function extractVinextNextDataJson(html: string): string | null;
+export declare function parseVinextNextDataJson(json: string): BrowserVinextNextData;
+export declare function applyVinextLocaleGlobals(target: VinextLocaleGlobalTarget, nextData: VinextNextData): void;
+//#endregion

package/dist/client/window-next.d.ts

@@ -81,7 +81,7 @@ type AppRouterPublicInstance = {
  * the resolved value via `browser.eval('await window.next.router.push(...)')`
  * to assert success.
  */
-type PagesRouterPublicInstance = {
+export type PagesRouterPublicInstance = {
   push: (...args: unknown[]) => Promise<boolean>;
   replace: (...args: unknown[]) => Promise<boolean>;
   back: () => void;
@@ -166,7 +166,6 @@ type WindowNext = {
  * so that a test (or userland code) that deletes `window.next` cleanly
  * resets state.
  */
-declare function installWindowNext(fields: Partial<WindowNext>): void;
-declare function setWindowNextInternalSourcePage(sourcePage: string | null): void;
-//#endregion
-export { PagesRouterPublicInstance, installWindowNext, setWindowNextInternalSourcePage };
+export declare function installWindowNext(fields: Partial<WindowNext>): void;
+export declare function setWindowNextInternalSourcePage(sourcePage: string | null): void;
+//#endregion

package/dist/config/config-matchers.d.ts

@@ -13,14 +13,14 @@ import { isExternalUrl } from "../utils/external-url.js";
  *
  * Returns true if the pattern appears safe, false if it's potentially dangerous.
  */
-declare function isSafeRegex(pattern: string, flags?: string): boolean;
+export declare function isSafeRegex(pattern: string, flags?: string): boolean;
 /**
  * Compile a regex pattern safely. Returns the compiled RegExp or null if the
  * pattern is invalid or vulnerable to ReDoS.
  *
  * Logs a warning when a pattern is rejected so developers can fix their config.
  */
-declare function safeRegExp(pattern: string, flags?: string): RegExp | null;
+export declare function safeRegExp(pattern: string, flags?: string): RegExp | null;
 /**
  * Convert a Next.js header/rewrite/redirect source pattern into a regex string.
  *
@@ -28,7 +28,7 @@ declare function safeRegExp(pattern: string, flags?: string): RegExp | null;
  * text is escaped/converted in a **single pass** (avoiding chained `.replace()`
  * which CodeQL flags as incomplete sanitization), then groups are restored.
  */
-declare function escapeHeaderSource(source: string): string;
+export declare function escapeHeaderSource(source: string): string;
 /**
  * basePath gating state passed alongside the pathname to every matcher.
  *
@@ -42,7 +42,7 @@ declare function escapeHeaderSource(source: string): string;
  *
  * @see .nextjs-ref/packages/next/src/lib/load-custom-routes.ts:198-220
  */
-type BasePathMatchState = {
+export type BasePathMatchState = {
   /** Configured `basePath` (without trailing slash) or "" when unset. */
   basePath: string;
   /**
@@ -69,12 +69,12 @@ type BasePathMatchState = {
  * individual header values), so the wider `string | string[]` type of
  * `middlewareHeaders` is safe to cast here.
  */
-declare function applyMiddlewareRequestHeaders(middlewareHeaders: Record<string, string | string[]>, request: Request): {
+export declare function applyMiddlewareRequestHeaders(middlewareHeaders: Record<string, string | string[]>, request: Request): {
   request: Request;
   postMwReqCtx: RequestContext;
 };
-declare function checkHasConditions(has: HasCondition[] | undefined, missing: HasCondition[] | undefined, ctx: RequestContext): boolean;
-declare function matchConfigPattern(pathname: string, pattern: string): Record<string, string> | null;
+export declare function checkHasConditions(has: HasCondition[] | undefined, missing: HasCondition[] | undefined, ctx: RequestContext): boolean;
+export declare function matchConfigPattern(pathname: string, pattern: string): Record<string, string> | null;
 /**
  * Apply redirect rules from next.config.js.
  * Returns the redirect info if a redirect was matched, or null.
@@ -110,7 +110,7 @@ declare function matchConfigPattern(pathname: string, pattern: string): Record<s
  * an original index < N are checked via matchConfigPattern first — they are
  * few in practice (typically zero) so this is not a hot-path concern.
  */
-declare function matchRedirect(pathname: string, redirects: NextRedirect[], ctx: RequestContext, basePathState?: BasePathMatchState): {
+export declare function matchRedirect(pathname: string, redirects: NextRedirect[], ctx: RequestContext, basePathState?: BasePathMatchState, onRuleSourceMatch?: (rule: NextRedirect) => void): {
   destination: string;
   permanent: boolean;
 } | null;
@@ -122,7 +122,7 @@ declare function matchRedirect(pathname: string, redirects: NextRedirect[], ctx:
  * to evaluate has/missing conditions. Next.js always has request context
  * when evaluating rewrites, so this parameter is required.
  */
-declare function matchRewrite(pathname: string, rewrites: NextRewrite[], ctx: RequestContext, basePathState?: BasePathMatchState, paramsPathname?: string): string | null;
+export declare function matchRewrite(pathname: string, rewrites: NextRewrite[], ctx: RequestContext, basePathState?: BasePathMatchState, paramsPathname?: string, onRuleSourceMatch?: (rule: NextRewrite) => void): string | null;
 /**
  * Check whether a rewrite source can match a pathname without evaluating its
  * request-dependent `has` / `missing` conditions.
@@ -132,7 +132,7 @@ declare function matchRewrite(pathname: string, rewrites: NextRewrite[], ctx: Re
  * evaluating them against the original request would incorrectly skip the
  * Pages request pipeline for file-looking paths.
  */
-declare function matchesRewriteSource(pathname: string, rewrite: NextRewrite, basePathState?: BasePathMatchState): boolean;
+export declare function matchesRewriteSource(pathname: string, rewrite: NextRewrite, basePathState?: BasePathMatchState): boolean;
 /**
  * Sanitize a redirect/rewrite destination to collapse protocol-relative URLs.
  *
@@ -144,7 +144,7 @@ declare function matchesRewriteSource(pathname: string, rewrite: NextRewrite, ba
  * This function collapses any leading double (or more) slashes to a single
  * slash for non-external (relative) destinations.
  */
-declare function sanitizeDestination(dest: string): string;
+export declare function sanitizeDestination(dest: string): string;
 /**
  * Check if a URL is external (absolute URL or protocol-relative).
  * Detects any URL scheme (http:, https:, data:, javascript:, blob:, etc.)
@@ -168,7 +168,7 @@ declare function sanitizeDestination(dest: string): string;
  * untouched (a config redirect to another origin should not leak the
  * original request's query).
  */
-declare function preserveRedirectDestinationQuery(destination: string, requestSearch: string): string;
+export declare function preserveRedirectDestinationQuery(destination: string, requestSearch: string): string;
 /**
  * Proxy an incoming request to an external URL and return the upstream response.
  *
@@ -178,7 +178,7 @@ declare function preserveRedirectDestinationQuery(destination: string, requestSe
  *
  * Works in all runtimes (Node.js, Cloudflare Workers) via the standard fetch() API.
  */
-declare function proxyExternalRequest(request: Request, externalUrl: string): Promise<Response>;
+export declare function proxyExternalRequest(request: Request, externalUrl: string): Promise<Response>;
 /**
  * Apply custom header rules from next.config.js.
  * Returns an array of { key, value } pairs to set on the response.
@@ -187,7 +187,7 @@ declare function proxyExternalRequest(request: Request, externalUrl: string): Pr
  * to evaluate has/missing conditions. Next.js always has request context
  * when evaluating headers, so this parameter is required.
  */
-declare function matchHeaders(pathname: string, headers: NextHeader[], ctx: RequestContext, basePathState?: BasePathMatchState): Array<{
+export declare function matchHeaders(pathname: string, headers: NextHeader[], ctx: RequestContext, basePathState?: BasePathMatchState, onRuleSourceMatch?: (rule: NextHeader) => void): Array<{
   key: string;
   value: string;
 }>;
@@ -224,8 +224,8 @@ declare function matchHeaders(pathname: string, headers: NextHeader[], ctx: Requ
  * Mirrors the Next.js reference in
  * packages/next/src/lib/load-custom-routes.ts — see `processRoutes`.
  */
-declare function applyLocaleToRoutes<T extends NextRedirect | NextRewrite | NextHeader>(routes: T[], i18n: NextI18nConfig | null | undefined, type: "redirect" | "rewrite" | "header", options?: {
+export declare function applyLocaleToRoutes<T extends NextRedirect | NextRewrite | NextHeader>(routes: T[], i18n: NextI18nConfig | null | undefined, type: "redirect" | "rewrite" | "header", options?: {
   trailingSlash?: boolean;
 }): T[];
 //#endregion
-export { BasePathMatchState, type RequestContext, applyLocaleToRoutes, applyMiddlewareRequestHeaders, checkHasConditions, escapeHeaderSource, isExternalUrl, isSafeRegex, matchConfigPattern, matchHeaders, matchRedirect, matchRewrite, matchesRewriteSource, normalizeHost, parseCookies, preserveRedirectDestinationQuery, proxyExternalRequest, requestContextFromRequest, safeRegExp, sanitizeDestination };
+export { type RequestContext, isExternalUrl, normalizeHost, parseCookies, requestContextFromRequest };