vinext 0.0.46 → 0.0.48

package/dist/shims/internal/als-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"als-registry.js","names":[],"sources":["../../../src/shims/internal/als-registry.ts"],"sourcesContent":["/**\n * Shared helper for registering AsyncLocalStorage instances on `globalThis`\n * via `Symbol.for(...)` so that they survive multiple module instances.\n *\n * Why this helper exists\n * ----------------------\n * Vite's multi-environment setup (RSC / SSR / client) and HMR can load a\n * single source module under several different specifiers, producing more\n * than one module instance at runtime. If each instance kept its own\n * module-local `new AsyncLocalStorage()`, request-scoped state would silently\n * fork across instances — `headers()` in one environment wouldn't see what\n * `connection()` registered in another, concurrent requests would stomp each\n * other, etc.\n *\n * The fix every shim was applying inline:\n *\n *   const _ALS_KEY = Symbol.for(\"vinext.foo.als\");\n *   const _g = globalThis as unknown as Record<PropertyKey, unknown>;\n *   const _als = (_g[_ALS_KEY] ??=\n *     new AsyncLocalStorage<T>()) as AsyncLocalStorage<T>;\n *\n * This helper packages that pattern.\n *\n * Cross-bundle singleton property — preserved\n * -------------------------------------------\n * - `Symbol.for(key)` consults the global symbol registry and returns the\n *   same symbol regardless of which module instance calls it.\n * - `globalThis[sym]` is a single slot shared by every module instance.\n * - `??=` only assigns when the slot is empty, so the first caller wins and\n *   every subsequent caller (in any module instance) reads the same ALS.\n *\n * The helper module itself never holds the ALS by reference — it always\n * round-trips through `globalThis`. So even if this helper file is itself\n * loaded under multiple module instances, every copy still hands back the\n * one true ALS for a given key.\n */\n\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\nconst _g = globalThis as unknown as Record<PropertyKey, unknown>;\n\n/**\n * Get (or lazily create) the AsyncLocalStorage registered on `globalThis`\n * under `Symbol.for(key)`. Multiple callers — including callers in different\n * module instances — that pass the same `key` receive the same ALS instance.\n *\n * @param key - String key fed to `Symbol.for(...)`. By convention vinext\n *   shims use a dotted namespace such as `\"vinext.cache.als\"`.\n */\nexport function getOrCreateAls<T>(key: string): AsyncLocalStorage<T> {\n  const sym = Symbol.for(key);\n  return (_g[sym] ??= new AsyncLocalStorage<T>()) as AsyncLocalStorage<T>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,MAAM,KAAK;;;;;;;;;AAUX,SAAgB,eAAkB,KAAmC;CACnE,MAAM,MAAM,OAAO,IAAI,IAAI;AAC3B,QAAQ,GAAG,SAAS,IAAI,mBAAsB"}

package/dist/shims/internal/cookie-serialize.d.ts

@@ -0,0 +1,46 @@
+//#region src/shims/internal/cookie-serialize.d.ts
+/**
+ * Shared Set-Cookie serialization for the next/headers and next/server shims.
+ *
+ * Two call sites — `cookies().set()` in headers.ts and `ResponseCookies.set()`
+ * in server.ts — produce identical Set-Cookie header strings. Keep the
+ * encoding, attribute order, and validation in one place so subtle RFC 6265
+ * details (escaping, attribute ordering, etc.) cannot drift between them.
+ *
+ * Note: this is a value-encoding helper for response cookies only. The
+ * request `Cookie:` header serialization in `RequestCookies._serialize`
+ * (server.ts) intentionally lives separately — it builds a different format
+ * (no attributes, just `name=value; name=value`) and shouldn't share this
+ * code.
+ */
+type SerializeSetCookieOptions = {
+  path?: string;
+  domain?: string;
+  maxAge?: number;
+  expires?: Date;
+  httpOnly?: boolean;
+  secure?: boolean;
+  sameSite?: "Strict" | "Lax" | "None";
+};
+declare function validateCookieName(name: string): void;
+/**
+ * Validate cookie attribute values (path, domain) to prevent injection
+ * via semicolons, newlines, or other control characters.
+ */
+declare function validateCookieAttributeValue(value: string, attributeName: string): void;
+/**
+ * Build a Set-Cookie header string from a cookie name, value, and attributes.
+ *
+ * - Encodes the value with `encodeURIComponent`.
+ * - Defaults `Path` to `/` (matching @edge-runtime/cookies and Next.js).
+ * - Validates path/domain to reject control characters and semicolons.
+ * - Emits attributes in the order: Path, Domain, Max-Age, Expires, HttpOnly,
+ *   Secure, SameSite.
+ *
+ * The caller is responsible for validating the cookie name (typically before
+ * mutating any internal state) via `validateCookieName`.
+ */
+declare function serializeSetCookie(name: string, value: string, options?: SerializeSetCookieOptions): string;
+//#endregion
+export { serializeSetCookie, validateCookieAttributeValue, validateCookieName };
+//# sourceMappingURL=cookie-serialize.d.ts.map

package/dist/shims/internal/cookie-serialize.js

@@ -0,0 +1,51 @@
+//#region src/shims/internal/cookie-serialize.ts
+/**
+* RFC 6265 §4.1.1: cookie-name is a token (RFC 2616 §2.2).
+* Allowed: any visible ASCII (0x21-0x7E) except separators: ()<>@,;:\"/[]?={}
+*/
+const VALID_COOKIE_NAME_RE = /^[\x21\x23-\x27\x2A\x2B\x2D\x2E\x30-\x39\x41-\x5A\x5E-\x7A\x7C\x7E]+$/;
+function validateCookieName(name) {
+	if (!name || !VALID_COOKIE_NAME_RE.test(name)) throw new Error(`Invalid cookie name: ${JSON.stringify(name)}`);
+}
+/**
+* Validate cookie attribute values (path, domain) to prevent injection
+* via semicolons, newlines, or other control characters.
+*/
+function validateCookieAttributeValue(value, attributeName) {
+	for (let i = 0; i < value.length; i++) {
+		const code = value.charCodeAt(i);
+		if (code <= 31 || code === 127 || value[i] === ";") throw new Error(`Invalid cookie ${attributeName} value: ${JSON.stringify(value)}`);
+	}
+}
+/**
+* Build a Set-Cookie header string from a cookie name, value, and attributes.
+*
+* - Encodes the value with `encodeURIComponent`.
+* - Defaults `Path` to `/` (matching @edge-runtime/cookies and Next.js).
+* - Validates path/domain to reject control characters and semicolons.
+* - Emits attributes in the order: Path, Domain, Max-Age, Expires, HttpOnly,
+*   Secure, SameSite.
+*
+* The caller is responsible for validating the cookie name (typically before
+* mutating any internal state) via `validateCookieName`.
+*/
+function serializeSetCookie(name, value, options) {
+	const parts = [`${name}=${encodeURIComponent(value)}`];
+	const path = options?.path ?? "/";
+	validateCookieAttributeValue(path, "Path");
+	parts.push(`Path=${path}`);
+	if (options?.domain) {
+		validateCookieAttributeValue(options.domain, "Domain");
+		parts.push(`Domain=${options.domain}`);
+	}
+	if (options?.maxAge !== void 0) parts.push(`Max-Age=${options.maxAge}`);
+	if (options?.expires) parts.push(`Expires=${options.expires.toUTCString()}`);
+	if (options?.httpOnly) parts.push("HttpOnly");
+	if (options?.secure) parts.push("Secure");
+	if (options?.sameSite) parts.push(`SameSite=${options.sameSite}`);
+	return parts.join("; ");
+}
+//#endregion
+export { serializeSetCookie, validateCookieAttributeValue, validateCookieName };
+
+//# sourceMappingURL=cookie-serialize.js.map

package/dist/shims/internal/cookie-serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-serialize.js","names":[],"sources":["../../../src/shims/internal/cookie-serialize.ts"],"sourcesContent":["/**\n * Shared Set-Cookie serialization for the next/headers and next/server shims.\n *\n * Two call sites — `cookies().set()` in headers.ts and `ResponseCookies.set()`\n * in server.ts — produce identical Set-Cookie header strings. Keep the\n * encoding, attribute order, and validation in one place so subtle RFC 6265\n * details (escaping, attribute ordering, etc.) cannot drift between them.\n *\n * Note: this is a value-encoding helper for response cookies only. The\n * request `Cookie:` header serialization in `RequestCookies._serialize`\n * (server.ts) intentionally lives separately — it builds a different format\n * (no attributes, just `name=value; name=value`) and shouldn't share this\n * code.\n */\n\ntype SerializeSetCookieOptions = {\n  path?: string;\n  domain?: string;\n  maxAge?: number;\n  expires?: Date;\n  httpOnly?: boolean;\n  secure?: boolean;\n  sameSite?: \"Strict\" | \"Lax\" | \"None\";\n};\n\n/**\n * RFC 6265 §4.1.1: cookie-name is a token (RFC 2616 §2.2).\n * Allowed: any visible ASCII (0x21-0x7E) except separators: ()<>@,;:\\\"/[]?={}\n */\nconst VALID_COOKIE_NAME_RE =\n  /^[\\x21\\x23-\\x27\\x2A\\x2B\\x2D\\x2E\\x30-\\x39\\x41-\\x5A\\x5E-\\x7A\\x7C\\x7E]+$/;\n\nexport function validateCookieName(name: string): void {\n  if (!name || !VALID_COOKIE_NAME_RE.test(name)) {\n    throw new Error(`Invalid cookie name: ${JSON.stringify(name)}`);\n  }\n}\n\n/**\n * Validate cookie attribute values (path, domain) to prevent injection\n * via semicolons, newlines, or other control characters.\n */\nexport function validateCookieAttributeValue(value: string, attributeName: string): void {\n  for (let i = 0; i < value.length; i++) {\n    const code = value.charCodeAt(i);\n    if (code <= 0x1f || code === 0x7f || value[i] === \";\") {\n      throw new Error(`Invalid cookie ${attributeName} value: ${JSON.stringify(value)}`);\n    }\n  }\n}\n\n/**\n * Build a Set-Cookie header string from a cookie name, value, and attributes.\n *\n * - Encodes the value with `encodeURIComponent`.\n * - Defaults `Path` to `/` (matching @edge-runtime/cookies and Next.js).\n * - Validates path/domain to reject control characters and semicolons.\n * - Emits attributes in the order: Path, Domain, Max-Age, Expires, HttpOnly,\n *   Secure, SameSite.\n *\n * The caller is responsible for validating the cookie name (typically before\n * mutating any internal state) via `validateCookieName`.\n */\nexport function serializeSetCookie(\n  name: string,\n  value: string,\n  options?: SerializeSetCookieOptions,\n): string {\n  const parts = [`${name}=${encodeURIComponent(value)}`];\n  const path = options?.path ?? \"/\";\n  validateCookieAttributeValue(path, \"Path\");\n  parts.push(`Path=${path}`);\n  if (options?.domain) {\n    validateCookieAttributeValue(options.domain, \"Domain\");\n    parts.push(`Domain=${options.domain}`);\n  }\n  if (options?.maxAge !== undefined) parts.push(`Max-Age=${options.maxAge}`);\n  if (options?.expires) parts.push(`Expires=${options.expires.toUTCString()}`);\n  if (options?.httpOnly) parts.push(\"HttpOnly\");\n  if (options?.secure) parts.push(\"Secure\");\n  if (options?.sameSite) parts.push(`SameSite=${options.sameSite}`);\n  return parts.join(\"; \");\n}\n"],"mappings":";;;;;AA6BA,MAAM,uBACJ;AAEF,SAAgB,mBAAmB,MAAoB;AACrD,KAAI,CAAC,QAAQ,CAAC,qBAAqB,KAAK,KAAK,CAC3C,OAAM,IAAI,MAAM,wBAAwB,KAAK,UAAU,KAAK,GAAG;;;;;;AAQnE,SAAgB,6BAA6B,OAAe,eAA6B;AACvF,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,OAAO,MAAM,WAAW,EAAE;AAChC,MAAI,QAAQ,MAAQ,SAAS,OAAQ,MAAM,OAAO,IAChD,OAAM,IAAI,MAAM,kBAAkB,cAAc,UAAU,KAAK,UAAU,MAAM,GAAG;;;;;;;;;;;;;;;AAiBxF,SAAgB,mBACd,MACA,OACA,SACQ;CACR,MAAM,QAAQ,CAAC,GAAG,KAAK,GAAG,mBAAmB,MAAM,GAAG;CACtD,MAAM,OAAO,SAAS,QAAQ;AAC9B,8BAA6B,MAAM,OAAO;AAC1C,OAAM,KAAK,QAAQ,OAAO;AAC1B,KAAI,SAAS,QAAQ;AACnB,+BAA6B,QAAQ,QAAQ,SAAS;AACtD,QAAM,KAAK,UAAU,QAAQ,SAAS;;AAExC,KAAI,SAAS,WAAW,KAAA,EAAW,OAAM,KAAK,WAAW,QAAQ,SAAS;AAC1E,KAAI,SAAS,QAAS,OAAM,KAAK,WAAW,QAAQ,QAAQ,aAAa,GAAG;AAC5E,KAAI,SAAS,SAAU,OAAM,KAAK,WAAW;AAC7C,KAAI,SAAS,OAAQ,OAAM,KAAK,SAAS;AACzC,KAAI,SAAS,SAAU,OAAM,KAAK,YAAY,QAAQ,WAAW;AACjE,QAAO,MAAM,KAAK,KAAK"}

package/dist/shims/link.js

@@ -3,8 +3,10 @@ import { isDangerousScheme } from "./url-safety.js";
 import { resolveRelativeHref, toBrowserNavigationHref, toSameOriginAppPath, withBasePath } from "./url-utils.js";
 import { addLocalePrefix, getDomainLocaleUrl } from "../utils/domain-locale.js";
 import { appendSearchParamsToUrl, urlQueryToSearchParams } from "../utils/query.js";
-import { createAppPayloadCacheKey } from "../server/app-elements.js";
-import { getCurrentInterceptionContext, getMountedSlotsHeader, getPrefetchedUrls, navigateClientSide, prefetchRscResponse, toRscUrl } from "./navigation.js";
+import { AppElementsWire } from "../server/app-elements-wire.js";
+import "../server/app-elements.js";
+import { VINEXT_RSC_MOUNTED_SLOTS_HEADER, createRscRequestHeaders, createRscRequestUrl } from "../server/app-rsc-cache-busting.js";
+import { getCurrentInterceptionContext, getMountedSlotsHeader, getPrefetchedUrls, navigateClientSide, prefetchRscResponse } from "./navigation.js";
 import { getI18nContext } from "./i18n-context.js";
 import React, { createContext, forwardRef, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { jsx } from "react/jsx-runtime";
@@ -55,31 +57,34 @@ function prefetchUrl(href) {
 		prefetchHref = localPath;
 	}
 	const fullHref = toBrowserNavigationHref(prefetchHref, window.location.href, __basePath);
-	const rscUrl = toRscUrl(fullHref);
-	const interceptionContext = getCurrentInterceptionContext();
-	const cacheKey = createAppPayloadCacheKey(rscUrl, interceptionContext);
-	const prefetched = getPrefetchedUrls();
-	if (prefetched.has(cacheKey)) return;
-	prefetched.add(cacheKey);
 	(window.requestIdleCallback ?? ((fn) => setTimeout(fn, 100)))(() => {
-		if (typeof window.__VINEXT_RSC_NAVIGATE__ === "function") {
-			const mountedSlotsHeader = getMountedSlotsHeader();
-			const headers = new Headers({ Accept: "text/x-component" });
-			if (mountedSlotsHeader) headers.set("X-Vinext-Mounted-Slots", mountedSlotsHeader);
-			if (interceptionContext !== null) headers.set("X-Vinext-Interception-Context", interceptionContext);
-			prefetchRscResponse(rscUrl, fetch(rscUrl, {
-				headers,
-				credentials: "include",
-				priority: "low",
-				purpose: "prefetch"
-			}), interceptionContext, mountedSlotsHeader);
-		} else if (window.__NEXT_DATA__?.__vinext?.pageModuleUrl) {
-			const link = document.createElement("link");
-			link.rel = "prefetch";
-			link.href = fullHref;
-			link.as = "document";
-			document.head.appendChild(link);
-		}
+		(async () => {
+			if (typeof window.__VINEXT_RSC_NAVIGATE__ === "function") {
+				const interceptionContext = getCurrentInterceptionContext();
+				const mountedSlotsHeader = getMountedSlotsHeader();
+				const headers = createRscRequestHeaders({ interceptionContext });
+				if (mountedSlotsHeader) headers.set(VINEXT_RSC_MOUNTED_SLOTS_HEADER, mountedSlotsHeader);
+				const rscUrl = await createRscRequestUrl(fullHref, headers);
+				const cacheKey = AppElementsWire.encodeCacheKey(rscUrl, interceptionContext);
+				const prefetched = getPrefetchedUrls();
+				if (prefetched.has(cacheKey)) return;
+				prefetched.add(cacheKey);
+				prefetchRscResponse(rscUrl, fetch(rscUrl, {
+					headers,
+					credentials: "include",
+					priority: "low",
+					purpose: "prefetch"
+				}), interceptionContext, mountedSlotsHeader);
+			} else if (window.__NEXT_DATA__?.__vinext?.pageModuleUrl) {
+				const link = document.createElement("link");
+				link.rel = "prefetch";
+				link.href = fullHref;
+				link.as = "document";
+				document.head.appendChild(link);
+			}
+		})().catch((error) => {
+			console.error("[vinext] RSC prefetch setup error:", error);
+		});
 	});
 }
 /**

package/dist/shims/link.js.map

@@ -1 +1 @@
-{"version":3,"file":"link.js","names":[],"sources":["../../src/shims/link.tsx"],"sourcesContent":["\"use client\";\n\n/**\n * next/link shim\n *\n * Renders an <a> tag with client-side navigation support.\n * On click, prevents full page reload and triggers client-side\n * page swap via the router's navigation system.\n */\nimport React, {\n  forwardRef,\n  useRef,\n  useEffect,\n  useCallback,\n  useContext,\n  createContext,\n  useState,\n  type AnchorHTMLAttributes,\n  type MouseEvent,\n} from \"react\";\n// Import shared RSC prefetch utilities from navigation shim (relative path\n// so this resolves both via the Vite plugin and in direct vitest imports)\nimport {\n  getCurrentInterceptionContext,\n  toRscUrl,\n  getPrefetchedUrls,\n  getMountedSlotsHeader,\n  navigateClientSide,\n  prefetchRscResponse,\n} from \"./navigation.js\";\nimport { createAppPayloadCacheKey } from \"../server/app-elements.js\";\nimport { isDangerousScheme } from \"./url-safety.js\";\nimport {\n  resolveRelativeHref,\n  toBrowserNavigationHref,\n  toSameOriginAppPath,\n  withBasePath,\n} from \"./url-utils.js\";\nimport { appendSearchParamsToUrl, type UrlQuery, urlQueryToSearchParams } from \"../utils/query.js\";\nimport { addLocalePrefix, getDomainLocaleUrl, type DomainLocale } from \"../utils/domain-locale.js\";\nimport { getI18nContext } from \"./i18n-context.js\";\nimport type { VinextNextData } from \"../client/vinext-next-data.js\";\n\ntype NavigateEvent = {\n  url: URL;\n  /** Call to prevent the Link's default navigation (e.g. for View Transitions). */\n  preventDefault(): void;\n  /** Whether preventDefault() has been called. */\n  defaultPrevented: boolean;\n};\n\ntype LinkProps = {\n  href: string | { pathname?: string; query?: UrlQuery };\n  /** URL displayed in the browser (when href is a route pattern like /user/[id]) */\n  as?: string;\n  /** Replace the current history entry instead of pushing */\n  replace?: boolean;\n  /** Prefetch the page in the background (default: true, uses IntersectionObserver) */\n  prefetch?: boolean;\n  /** Whether to pass the href to the child element */\n  passHref?: boolean;\n  /** Scroll to top on navigation (default: true) */\n  scroll?: boolean;\n  /** Locale for i18n (used for locale-prefixed URLs) */\n  locale?: string | false;\n  /** Called before navigation happens (Next.js 16). Return value is ignored. */\n  onNavigate?: (event: NavigateEvent) => void;\n  children?: React.ReactNode;\n} & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, \"href\">;\n\n// ---------------------------------------------------------------------------\n// useLinkStatus — reports the pending state of a parent <Link> navigation\n// ---------------------------------------------------------------------------\n\ntype LinkStatusContextValue = {\n  pending: boolean;\n};\n\nconst LinkStatusContext = createContext<LinkStatusContextValue>({ pending: false });\n\n/**\n * useLinkStatus returns the pending state of the enclosing <Link>.\n * In Next.js, this is used to show loading indicators while a\n * prefetch-triggered navigation is in progress.\n */\nexport function useLinkStatus(): LinkStatusContextValue {\n  return useContext(LinkStatusContext);\n}\n\n/** basePath from next.config.js, injected by the plugin at build time */\nconst __basePath: string = process.env.__NEXT_ROUTER_BASEPATH ?? \"\";\n\nfunction resolveHref(href: LinkProps[\"href\"]): string {\n  if (typeof href === \"string\") return href;\n  let url = href.pathname ?? \"/\";\n  if (href.query) {\n    const params = urlQueryToSearchParams(href.query);\n    url = appendSearchParamsToUrl(url, params);\n  }\n  return url;\n}\n\n// ---------------------------------------------------------------------------\n// Prefetching infrastructure\n// ---------------------------------------------------------------------------\n\n/**\n * Prefetch a URL for faster navigation.\n *\n * For App Router (RSC): fetches the .rsc payload in the background and\n * stores it in an in-memory cache for instant use during navigation.\n * For Pages Router: injects a <link rel=\"prefetch\"> for the page module.\n *\n * Uses `requestIdleCallback` (or `setTimeout` fallback) to avoid blocking\n * the main thread during initial page load.\n */\nfunction prefetchUrl(href: string): void {\n  if (typeof window === \"undefined\") return;\n\n  // Normalize same-origin absolute URLs to local paths before prefetching\n  let prefetchHref = href;\n  if (href.startsWith(\"http://\") || href.startsWith(\"https://\") || href.startsWith(\"//\")) {\n    const localPath = toSameOriginAppPath(href, __basePath);\n    if (localPath == null) return; // truly external — don't prefetch\n    prefetchHref = localPath;\n  }\n\n  const fullHref = toBrowserNavigationHref(prefetchHref, window.location.href, __basePath);\n\n  // Distinguish the same visible URL when it is prefetched from different\n  // interception sources such as /feed vs /gallery.\n  const rscUrl = toRscUrl(fullHref);\n  const interceptionContext = getCurrentInterceptionContext();\n  const cacheKey = createAppPayloadCacheKey(rscUrl, interceptionContext);\n  const prefetched = getPrefetchedUrls();\n  if (prefetched.has(cacheKey)) return;\n  prefetched.add(cacheKey);\n\n  const schedule = window.requestIdleCallback ?? ((fn: () => void) => setTimeout(fn, 100));\n\n  schedule(() => {\n    if (typeof window.__VINEXT_RSC_NAVIGATE__ === \"function\") {\n      const mountedSlotsHeader = getMountedSlotsHeader();\n      const headers = new Headers({ Accept: \"text/x-component\" });\n      if (mountedSlotsHeader) {\n        headers.set(\"X-Vinext-Mounted-Slots\", mountedSlotsHeader);\n      }\n      if (interceptionContext !== null) {\n        headers.set(\"X-Vinext-Interception-Context\", interceptionContext);\n      }\n      prefetchRscResponse(\n        rscUrl,\n        fetch(rscUrl, {\n          headers,\n          credentials: \"include\",\n          priority: \"low\" as const,\n          // @ts-expect-error — purpose is a valid fetch option in some browsers\n          purpose: \"prefetch\",\n        }),\n        interceptionContext,\n        mountedSlotsHeader,\n      );\n    } else if ((window.__NEXT_DATA__ as VinextNextData | undefined)?.__vinext?.pageModuleUrl) {\n      // Pages Router: inject a prefetch link for the target page module\n      // We can't easily resolve the target page's module URL from the Link,\n      // so we create a <link rel=\"prefetch\"> for the HTML page which helps\n      // the browser's preload scanner.\n      const link = document.createElement(\"link\");\n      link.rel = \"prefetch\";\n      link.href = fullHref;\n      link.as = \"document\";\n      document.head.appendChild(link);\n    }\n  });\n}\n\n/**\n * Shared IntersectionObserver for viewport-based prefetching.\n * All Link elements use the same observer to minimize resource usage.\n */\nlet sharedObserver: IntersectionObserver | null = null;\nconst observerCallbacks = new WeakMap<Element, () => void>();\n\nfunction getSharedObserver(): IntersectionObserver | null {\n  if (typeof window === \"undefined\" || typeof IntersectionObserver === \"undefined\") return null;\n  if (sharedObserver) return sharedObserver;\n\n  sharedObserver = new IntersectionObserver(\n    (entries) => {\n      for (const entry of entries) {\n        if (entry.isIntersecting) {\n          const callback = observerCallbacks.get(entry.target);\n          if (callback) {\n            callback();\n            // Unobserve after prefetching — only prefetch once\n            sharedObserver?.unobserve(entry.target);\n            observerCallbacks.delete(entry.target);\n          }\n        }\n      }\n    },\n    {\n      // Start prefetching when the link is within 250px of the viewport.\n      // This gives the browser a head start before the user scrolls to it.\n      rootMargin: \"250px\",\n    },\n  );\n\n  return sharedObserver;\n}\n\nfunction getDefaultLocale(): string | undefined {\n  if (typeof window !== \"undefined\") {\n    return window.__VINEXT_DEFAULT_LOCALE__;\n  }\n  return getI18nContext()?.defaultLocale;\n}\n\nfunction getDomainLocales(): readonly DomainLocale[] | undefined {\n  if (typeof window !== \"undefined\") {\n    return (window.__NEXT_DATA__ as VinextNextData | undefined)?.domainLocales;\n  }\n  return getI18nContext()?.domainLocales;\n}\n\nfunction getCurrentHostname(): string | undefined {\n  if (typeof window !== \"undefined\") return window.location.hostname;\n  return getI18nContext()?.hostname;\n}\n\nfunction getDomainLocaleHref(href: string, locale: string): string | undefined {\n  // Only cross-domain locale switches need a special absolute URL here.\n  // Same-domain cases fall back to the standard locale-prefix logic below.\n  return getDomainLocaleUrl(href, locale, {\n    basePath: __basePath,\n    currentHostname: getCurrentHostname(),\n    domainItems: getDomainLocales(),\n  });\n}\n\n/**\n * Apply locale prefix to a URL path based on the locale prop.\n * - locale=\"fr\" → prepend /fr (unless it already has a locale prefix)\n * - locale={false} → use the href as-is (no locale prefix, link to default)\n * - locale=undefined → use current locale (href as-is in most cases)\n */\nfunction applyLocaleToHref(href: string, locale: string | false | undefined): string {\n  if (locale === false) {\n    // Explicit false: no locale prefix\n    return href;\n  }\n\n  if (locale === undefined) {\n    // No locale prop: keep current behavior (href as-is)\n    return href;\n  }\n\n  // Absolute and protocol-relative URLs must not be prefixed — locale\n  // only applies to local paths.\n  if (href.startsWith(\"http://\") || href.startsWith(\"https://\") || href.startsWith(\"//\")) {\n    return href;\n  }\n\n  const domainLocaleHref = getDomainLocaleHref(href, locale);\n  if (domainLocaleHref) {\n    return domainLocaleHref;\n  }\n\n  return addLocalePrefix(href, locale, getDefaultLocale() ?? \"\");\n}\n\nconst Link = forwardRef<HTMLAnchorElement, LinkProps>(function Link(\n  {\n    href,\n    as,\n    replace = false,\n    prefetch: prefetchProp,\n    scroll = true,\n    children,\n    onClick,\n    onNavigate,\n    ...rest\n  },\n  forwardedRef,\n) {\n  // Extract locale from rest props\n  const { locale, ...restWithoutLocale } = rest;\n\n  // If `as` is provided, use it as the actual URL (legacy Next.js pattern\n  // where href is a route pattern like \"/user/[id]\" and as is \"/user/1\")\n  const resolvedHref = as ?? resolveHref(href);\n\n  const isDangerous = typeof resolvedHref === \"string\" && isDangerousScheme(resolvedHref);\n\n  // Apply locale prefix if specified (safe even for dangerous hrefs since we\n  // won't use the result when isDangerous is true)\n  const localizedHref = applyLocaleToHref(isDangerous ? \"/\" : resolvedHref, locale);\n  // Full href with basePath for browser URLs and fetches\n  const fullHref = withBasePath(localizedHref, __basePath);\n\n  // Track pending state for useLinkStatus()\n  const [pending, setPending] = useState(false);\n  const mountedRef = useRef(true);\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n    };\n  }, []);\n\n  // Prefetching: observe the element when it enters the viewport.\n  // prefetch={false} disables, prefetch={true} or undefined/null (default) enables.\n  const internalRef = useRef<HTMLAnchorElement | null>(null);\n  const shouldPrefetch = prefetchProp !== false && !isDangerous;\n\n  const setRefs = useCallback(\n    (node: HTMLAnchorElement | null) => {\n      internalRef.current = node;\n      if (typeof forwardedRef === \"function\") forwardedRef(node);\n      else if (forwardedRef)\n        (forwardedRef as React.MutableRefObject<HTMLAnchorElement | null>).current = node;\n    },\n    [forwardedRef],\n  );\n\n  useEffect(() => {\n    if (!shouldPrefetch || typeof window === \"undefined\") return;\n    const node = internalRef.current;\n    if (!node) return;\n\n    // Normalize same-origin absolute URLs; skip truly external ones\n    let hrefToPrefetch = localizedHref;\n    if (\n      localizedHref.startsWith(\"http://\") ||\n      localizedHref.startsWith(\"https://\") ||\n      localizedHref.startsWith(\"//\")\n    ) {\n      const localPath = toSameOriginAppPath(localizedHref, __basePath);\n      if (localPath == null) return; // truly external\n      hrefToPrefetch = localPath;\n    }\n\n    const observer = getSharedObserver();\n    if (!observer) return;\n\n    observerCallbacks.set(node, () => prefetchUrl(hrefToPrefetch));\n    observer.observe(node);\n\n    return () => {\n      observer.unobserve(node);\n      observerCallbacks.delete(node);\n    };\n  }, [shouldPrefetch, localizedHref]);\n\n  const handleClick = async (e: MouseEvent<HTMLAnchorElement>) => {\n    if (onClick) onClick(e);\n    if (e.defaultPrevented) return;\n\n    // Only intercept left clicks without modifiers (standard link behavior)\n    if (e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) {\n      return;\n    }\n\n    // Don't intercept links with target (e.g. target=\"_blank\")\n    if (e.currentTarget.target && e.currentTarget.target !== \"_self\") {\n      return;\n    }\n\n    // External links: let the browser handle it.\n    // Same-origin absolute URLs (e.g. http://localhost:3000/about) are\n    // normalized to local paths so they get client-side navigation.\n    let navigateHref = localizedHref;\n    if (\n      resolvedHref.startsWith(\"http://\") ||\n      resolvedHref.startsWith(\"https://\") ||\n      resolvedHref.startsWith(\"//\")\n    ) {\n      const localPath = toSameOriginAppPath(resolvedHref, __basePath);\n      if (localPath == null) return; // truly external\n      navigateHref = localPath;\n    }\n\n    e.preventDefault();\n\n    // Resolve relative hrefs (#hash, ?query) against the current URL once so\n    // onNavigate and the actual navigation target stay in sync.\n    const absoluteHref = resolveRelativeHref(navigateHref, window.location.href, __basePath);\n    const absoluteFullHref = toBrowserNavigationHref(\n      navigateHref,\n      window.location.href,\n      __basePath,\n    );\n\n    // Call onNavigate callback if provided (Next.js 16 View Transitions support)\n    if (onNavigate) {\n      try {\n        const navUrl = new URL(absoluteFullHref, window.location.origin);\n        let prevented = false;\n        const navEvent: NavigateEvent = {\n          url: navUrl,\n          preventDefault() {\n            prevented = true;\n          },\n          get defaultPrevented() {\n            return prevented;\n          },\n        };\n        onNavigate(navEvent);\n        // If the callback called preventDefault(), skip Link's default navigation.\n        // The callback is responsible for its own navigation (e.g. via View Transitions API).\n        if (navEvent.defaultPrevented) {\n          return;\n        }\n      } catch {\n        // Ignore URL parsing errors for relative/hash hrefs\n      }\n    }\n\n    // App Router: delegate to navigateClientSide which handles scroll save,\n    // hash-only changes, RSC fetch, and two-phase URL commit.\n    if (typeof window.__VINEXT_RSC_NAVIGATE__ === \"function\") {\n      setPending(true);\n      try {\n        await navigateClientSide(navigateHref, replace ? \"replace\" : \"push\", scroll);\n      } finally {\n        if (mountedRef.current) setPending(false);\n      }\n    } else {\n      // Next.js only consumes onRouterTransitionStart in the App Router.\n      // Pages Router still executes instrumentation-client side effects\n      // during startup, but it does not invoke the named export on navigation.\n      // Pages Router: use the Router singleton\n      try {\n        const routerModule = await import(\"next/router\");\n        // oxlint-disable-next-line @typescript-eslint/no-explicit-any -- vinext's Router shim accepts (url, as, options)\n        const Router = routerModule.default as any;\n        if (replace) {\n          await Router.replace(absoluteHref, undefined, { scroll });\n        } else {\n          await Router.push(absoluteHref, undefined, { scroll });\n        }\n      } catch {\n        // Fallback to hard navigation if router fails\n        if (replace) {\n          window.history.replaceState({}, \"\", absoluteFullHref);\n        } else {\n          window.history.pushState({}, \"\", absoluteFullHref);\n        }\n        window.dispatchEvent(new PopStateEvent(\"popstate\"));\n      }\n    }\n  };\n\n  // Remove props that shouldn't be on <a>\n  const { passHref: _p, ...anchorProps } = restWithoutLocale;\n\n  const linkStatusValue = React.useMemo(() => ({ pending }), [pending]);\n\n  // Block dangerous URI schemes (javascript:, data:, vbscript:).\n  // Render an inert <a> without href to prevent XSS while preserving\n  // styling and attributes like className, id, aria-*.\n  // This check is placed after all hooks to satisfy the Rules of Hooks.\n  if (isDangerous) {\n    if (process.env.NODE_ENV !== \"production\") {\n      console.warn(`<Link> blocked dangerous href: ${resolvedHref}`);\n    }\n    return <a {...anchorProps}>{children}</a>;\n  }\n\n  return (\n    <LinkStatusContext.Provider value={linkStatusValue}>\n      <a ref={setRefs} href={fullHref} onClick={handleClick} {...anchorProps}>\n        {children}\n      </a>\n    </LinkStatusContext.Provider>\n  );\n});\n\nexport default Link;\n"],"mappings":"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"}
+{"version":3,"file":"link.js","names":[],"sources":["../../src/shims/link.tsx"],"sourcesContent":["\"use client\";\n\n/**\n * next/link shim\n *\n * Renders an <a> tag with client-side navigation support.\n * On click, prevents full page reload and triggers client-side\n * page swap via the router's navigation system.\n */\nimport React, {\n  forwardRef,\n  useRef,\n  useEffect,\n  useCallback,\n  useContext,\n  createContext,\n  useState,\n  type AnchorHTMLAttributes,\n  type MouseEvent,\n} from \"react\";\n// Import shared RSC prefetch utilities from navigation shim (relative path\n// so this resolves both via the Vite plugin and in direct vitest imports)\nimport {\n  getCurrentInterceptionContext,\n  getPrefetchedUrls,\n  getMountedSlotsHeader,\n  navigateClientSide,\n  prefetchRscResponse,\n} from \"./navigation.js\";\nimport { AppElementsWire } from \"../server/app-elements.js\";\nimport {\n  createRscRequestHeaders,\n  createRscRequestUrl,\n  VINEXT_RSC_MOUNTED_SLOTS_HEADER,\n} from \"../server/app-rsc-cache-busting.js\";\nimport { isDangerousScheme } from \"./url-safety.js\";\nimport {\n  resolveRelativeHref,\n  toBrowserNavigationHref,\n  toSameOriginAppPath,\n  withBasePath,\n} from \"./url-utils.js\";\nimport { appendSearchParamsToUrl, type UrlQuery, urlQueryToSearchParams } from \"../utils/query.js\";\nimport { addLocalePrefix, getDomainLocaleUrl, type DomainLocale } from \"../utils/domain-locale.js\";\nimport { getI18nContext } from \"./i18n-context.js\";\nimport type { VinextNextData } from \"../client/vinext-next-data.js\";\n\ntype NavigateEvent = {\n  url: URL;\n  /** Call to prevent the Link's default navigation (e.g. for View Transitions). */\n  preventDefault(): void;\n  /** Whether preventDefault() has been called. */\n  defaultPrevented: boolean;\n};\n\ntype LinkProps = {\n  href: string | { pathname?: string; query?: UrlQuery };\n  /** URL displayed in the browser (when href is a route pattern like /user/[id]) */\n  as?: string;\n  /** Replace the current history entry instead of pushing */\n  replace?: boolean;\n  /** Prefetch the page in the background (default: true, uses IntersectionObserver) */\n  prefetch?: boolean;\n  /** Whether to pass the href to the child element */\n  passHref?: boolean;\n  /** Scroll to top on navigation (default: true) */\n  scroll?: boolean;\n  /** Locale for i18n (used for locale-prefixed URLs) */\n  locale?: string | false;\n  /** Called before navigation happens (Next.js 16). Return value is ignored. */\n  onNavigate?: (event: NavigateEvent) => void;\n  children?: React.ReactNode;\n} & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, \"href\">;\n\n// ---------------------------------------------------------------------------\n// useLinkStatus — reports the pending state of a parent <Link> navigation\n// ---------------------------------------------------------------------------\n\ntype LinkStatusContextValue = {\n  pending: boolean;\n};\n\nconst LinkStatusContext = createContext<LinkStatusContextValue>({ pending: false });\n\n/**\n * useLinkStatus returns the pending state of the enclosing <Link>.\n * In Next.js, this is used to show loading indicators while a\n * prefetch-triggered navigation is in progress.\n */\nexport function useLinkStatus(): LinkStatusContextValue {\n  return useContext(LinkStatusContext);\n}\n\n/** basePath from next.config.js, injected by the plugin at build time */\nconst __basePath: string = process.env.__NEXT_ROUTER_BASEPATH ?? \"\";\n\nfunction resolveHref(href: LinkProps[\"href\"]): string {\n  if (typeof href === \"string\") return href;\n  let url = href.pathname ?? \"/\";\n  if (href.query) {\n    const params = urlQueryToSearchParams(href.query);\n    url = appendSearchParamsToUrl(url, params);\n  }\n  return url;\n}\n\n// ---------------------------------------------------------------------------\n// Prefetching infrastructure\n// ---------------------------------------------------------------------------\n\n/**\n * Prefetch a URL for faster navigation.\n *\n * For App Router (RSC): fetches the .rsc payload in the background and\n * stores it in an in-memory cache for instant use during navigation.\n * For Pages Router: injects a <link rel=\"prefetch\"> for the page module.\n *\n * Uses `requestIdleCallback` (or `setTimeout` fallback) to avoid blocking\n * the main thread during initial page load.\n */\nfunction prefetchUrl(href: string): void {\n  if (typeof window === \"undefined\") return;\n\n  // Normalize same-origin absolute URLs to local paths before prefetching\n  let prefetchHref = href;\n  if (href.startsWith(\"http://\") || href.startsWith(\"https://\") || href.startsWith(\"//\")) {\n    const localPath = toSameOriginAppPath(href, __basePath);\n    if (localPath == null) return; // truly external — don't prefetch\n    prefetchHref = localPath;\n  }\n\n  const fullHref = toBrowserNavigationHref(prefetchHref, window.location.href, __basePath);\n\n  const schedule = window.requestIdleCallback ?? ((fn: () => void) => setTimeout(fn, 100));\n\n  schedule(() => {\n    void (async () => {\n      if (typeof window.__VINEXT_RSC_NAVIGATE__ === \"function\") {\n        const interceptionContext = getCurrentInterceptionContext();\n        const mountedSlotsHeader = getMountedSlotsHeader();\n        const headers = createRscRequestHeaders({ interceptionContext });\n        if (mountedSlotsHeader) {\n          headers.set(VINEXT_RSC_MOUNTED_SLOTS_HEADER, mountedSlotsHeader);\n        }\n        // Distinguish the same visible URL when it is prefetched from different\n        // request contexts such as /feed vs /gallery or different mounted slots.\n        const rscUrl = await createRscRequestUrl(fullHref, headers);\n        const cacheKey = AppElementsWire.encodeCacheKey(rscUrl, interceptionContext);\n        const prefetched = getPrefetchedUrls();\n        if (prefetched.has(cacheKey)) return;\n        prefetched.add(cacheKey);\n        prefetchRscResponse(\n          rscUrl,\n          fetch(rscUrl, {\n            headers,\n            credentials: \"include\",\n            priority: \"low\" as const,\n            // @ts-expect-error — purpose is a valid fetch option in some browsers\n            purpose: \"prefetch\",\n          }),\n          interceptionContext,\n          mountedSlotsHeader,\n        );\n      } else if ((window.__NEXT_DATA__ as VinextNextData | undefined)?.__vinext?.pageModuleUrl) {\n        // Pages Router: inject a prefetch link for the target page module\n        // We can't easily resolve the target page's module URL from the Link,\n        // so we create a <link rel=\"prefetch\"> for the HTML page which helps\n        // the browser's preload scanner.\n        const link = document.createElement(\"link\");\n        link.rel = \"prefetch\";\n        link.href = fullHref;\n        link.as = \"document\";\n        document.head.appendChild(link);\n      }\n    })().catch((error) => {\n      console.error(\"[vinext] RSC prefetch setup error:\", error);\n    });\n  });\n}\n\n/**\n * Shared IntersectionObserver for viewport-based prefetching.\n * All Link elements use the same observer to minimize resource usage.\n */\nlet sharedObserver: IntersectionObserver | null = null;\nconst observerCallbacks = new WeakMap<Element, () => void>();\n\nfunction getSharedObserver(): IntersectionObserver | null {\n  if (typeof window === \"undefined\" || typeof IntersectionObserver === \"undefined\") return null;\n  if (sharedObserver) return sharedObserver;\n\n  sharedObserver = new IntersectionObserver(\n    (entries) => {\n      for (const entry of entries) {\n        if (entry.isIntersecting) {\n          const callback = observerCallbacks.get(entry.target);\n          if (callback) {\n            callback();\n            // Unobserve after prefetching — only prefetch once\n            sharedObserver?.unobserve(entry.target);\n            observerCallbacks.delete(entry.target);\n          }\n        }\n      }\n    },\n    {\n      // Start prefetching when the link is within 250px of the viewport.\n      // This gives the browser a head start before the user scrolls to it.\n      rootMargin: \"250px\",\n    },\n  );\n\n  return sharedObserver;\n}\n\nfunction getDefaultLocale(): string | undefined {\n  if (typeof window !== \"undefined\") {\n    return window.__VINEXT_DEFAULT_LOCALE__;\n  }\n  return getI18nContext()?.defaultLocale;\n}\n\nfunction getDomainLocales(): readonly DomainLocale[] | undefined {\n  if (typeof window !== \"undefined\") {\n    return (window.__NEXT_DATA__ as VinextNextData | undefined)?.domainLocales;\n  }\n  return getI18nContext()?.domainLocales;\n}\n\nfunction getCurrentHostname(): string | undefined {\n  if (typeof window !== \"undefined\") return window.location.hostname;\n  return getI18nContext()?.hostname;\n}\n\nfunction getDomainLocaleHref(href: string, locale: string): string | undefined {\n  // Only cross-domain locale switches need a special absolute URL here.\n  // Same-domain cases fall back to the standard locale-prefix logic below.\n  return getDomainLocaleUrl(href, locale, {\n    basePath: __basePath,\n    currentHostname: getCurrentHostname(),\n    domainItems: getDomainLocales(),\n  });\n}\n\n/**\n * Apply locale prefix to a URL path based on the locale prop.\n * - locale=\"fr\" → prepend /fr (unless it already has a locale prefix)\n * - locale={false} → use the href as-is (no locale prefix, link to default)\n * - locale=undefined → use current locale (href as-is in most cases)\n */\nfunction applyLocaleToHref(href: string, locale: string | false | undefined): string {\n  if (locale === false) {\n    // Explicit false: no locale prefix\n    return href;\n  }\n\n  if (locale === undefined) {\n    // No locale prop: keep current behavior (href as-is)\n    return href;\n  }\n\n  // Absolute and protocol-relative URLs must not be prefixed — locale\n  // only applies to local paths.\n  if (href.startsWith(\"http://\") || href.startsWith(\"https://\") || href.startsWith(\"//\")) {\n    return href;\n  }\n\n  const domainLocaleHref = getDomainLocaleHref(href, locale);\n  if (domainLocaleHref) {\n    return domainLocaleHref;\n  }\n\n  return addLocalePrefix(href, locale, getDefaultLocale() ?? \"\");\n}\n\nconst Link = forwardRef<HTMLAnchorElement, LinkProps>(function Link(\n  {\n    href,\n    as,\n    replace = false,\n    prefetch: prefetchProp,\n    scroll = true,\n    children,\n    onClick,\n    onNavigate,\n    ...rest\n  },\n  forwardedRef,\n) {\n  // Extract locale from rest props\n  const { locale, ...restWithoutLocale } = rest;\n\n  // If `as` is provided, use it as the actual URL (legacy Next.js pattern\n  // where href is a route pattern like \"/user/[id]\" and as is \"/user/1\")\n  const resolvedHref = as ?? resolveHref(href);\n\n  const isDangerous = typeof resolvedHref === \"string\" && isDangerousScheme(resolvedHref);\n\n  // Apply locale prefix if specified (safe even for dangerous hrefs since we\n  // won't use the result when isDangerous is true)\n  const localizedHref = applyLocaleToHref(isDangerous ? \"/\" : resolvedHref, locale);\n  // Full href with basePath for browser URLs and fetches\n  const fullHref = withBasePath(localizedHref, __basePath);\n\n  // Track pending state for useLinkStatus()\n  const [pending, setPending] = useState(false);\n  const mountedRef = useRef(true);\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n    };\n  }, []);\n\n  // Prefetching: observe the element when it enters the viewport.\n  // prefetch={false} disables, prefetch={true} or undefined/null (default) enables.\n  const internalRef = useRef<HTMLAnchorElement | null>(null);\n  const shouldPrefetch = prefetchProp !== false && !isDangerous;\n\n  const setRefs = useCallback(\n    (node: HTMLAnchorElement | null) => {\n      internalRef.current = node;\n      if (typeof forwardedRef === \"function\") forwardedRef(node);\n      else if (forwardedRef)\n        (forwardedRef as React.MutableRefObject<HTMLAnchorElement | null>).current = node;\n    },\n    [forwardedRef],\n  );\n\n  useEffect(() => {\n    if (!shouldPrefetch || typeof window === \"undefined\") return;\n    const node = internalRef.current;\n    if (!node) return;\n\n    // Normalize same-origin absolute URLs; skip truly external ones\n    let hrefToPrefetch = localizedHref;\n    if (\n      localizedHref.startsWith(\"http://\") ||\n      localizedHref.startsWith(\"https://\") ||\n      localizedHref.startsWith(\"//\")\n    ) {\n      const localPath = toSameOriginAppPath(localizedHref, __basePath);\n      if (localPath == null) return; // truly external\n      hrefToPrefetch = localPath;\n    }\n\n    const observer = getSharedObserver();\n    if (!observer) return;\n\n    observerCallbacks.set(node, () => prefetchUrl(hrefToPrefetch));\n    observer.observe(node);\n\n    return () => {\n      observer.unobserve(node);\n      observerCallbacks.delete(node);\n    };\n  }, [shouldPrefetch, localizedHref]);\n\n  const handleClick = async (e: MouseEvent<HTMLAnchorElement>) => {\n    if (onClick) onClick(e);\n    if (e.defaultPrevented) return;\n\n    // Only intercept left clicks without modifiers (standard link behavior)\n    if (e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) {\n      return;\n    }\n\n    // Don't intercept links with target (e.g. target=\"_blank\")\n    if (e.currentTarget.target && e.currentTarget.target !== \"_self\") {\n      return;\n    }\n\n    // External links: let the browser handle it.\n    // Same-origin absolute URLs (e.g. http://localhost:3000/about) are\n    // normalized to local paths so they get client-side navigation.\n    let navigateHref = localizedHref;\n    if (\n      resolvedHref.startsWith(\"http://\") ||\n      resolvedHref.startsWith(\"https://\") ||\n      resolvedHref.startsWith(\"//\")\n    ) {\n      const localPath = toSameOriginAppPath(resolvedHref, __basePath);\n      if (localPath == null) return; // truly external\n      navigateHref = localPath;\n    }\n\n    e.preventDefault();\n\n    // Resolve relative hrefs (#hash, ?query) against the current URL once so\n    // onNavigate and the actual navigation target stay in sync.\n    const absoluteHref = resolveRelativeHref(navigateHref, window.location.href, __basePath);\n    const absoluteFullHref = toBrowserNavigationHref(\n      navigateHref,\n      window.location.href,\n      __basePath,\n    );\n\n    // Call onNavigate callback if provided (Next.js 16 View Transitions support)\n    if (onNavigate) {\n      try {\n        const navUrl = new URL(absoluteFullHref, window.location.origin);\n        let prevented = false;\n        const navEvent: NavigateEvent = {\n          url: navUrl,\n          preventDefault() {\n            prevented = true;\n          },\n          get defaultPrevented() {\n            return prevented;\n          },\n        };\n        onNavigate(navEvent);\n        // If the callback called preventDefault(), skip Link's default navigation.\n        // The callback is responsible for its own navigation (e.g. via View Transitions API).\n        if (navEvent.defaultPrevented) {\n          return;\n        }\n      } catch {\n        // Ignore URL parsing errors for relative/hash hrefs\n      }\n    }\n\n    // App Router: delegate to navigateClientSide which handles scroll save,\n    // hash-only changes, RSC fetch, and two-phase URL commit.\n    if (typeof window.__VINEXT_RSC_NAVIGATE__ === \"function\") {\n      setPending(true);\n      try {\n        await navigateClientSide(navigateHref, replace ? \"replace\" : \"push\", scroll);\n      } finally {\n        if (mountedRef.current) setPending(false);\n      }\n    } else {\n      // Next.js only consumes onRouterTransitionStart in the App Router.\n      // Pages Router still executes instrumentation-client side effects\n      // during startup, but it does not invoke the named export on navigation.\n      // Pages Router: use the Router singleton\n      try {\n        const routerModule = await import(\"next/router\");\n        // oxlint-disable-next-line @typescript-eslint/no-explicit-any -- vinext's Router shim accepts (url, as, options)\n        const Router = routerModule.default as any;\n        if (replace) {\n          await Router.replace(absoluteHref, undefined, { scroll });\n        } else {\n          await Router.push(absoluteHref, undefined, { scroll });\n        }\n      } catch {\n        // Fallback to hard navigation if router fails\n        if (replace) {\n          window.history.replaceState({}, \"\", absoluteFullHref);\n        } else {\n          window.history.pushState({}, \"\", absoluteFullHref);\n        }\n        window.dispatchEvent(new PopStateEvent(\"popstate\"));\n      }\n    }\n  };\n\n  // Remove props that shouldn't be on <a>\n  const { passHref: _p, ...anchorProps } = restWithoutLocale;\n\n  const linkStatusValue = React.useMemo(() => ({ pending }), [pending]);\n\n  // Block dangerous URI schemes (javascript:, data:, vbscript:).\n  // Render an inert <a> without href to prevent XSS while preserving\n  // styling and attributes like className, id, aria-*.\n  // This check is placed after all hooks to satisfy the Rules of Hooks.\n  if (isDangerous) {\n    if (process.env.NODE_ENV !== \"production\") {\n      console.warn(`<Link> blocked dangerous href: ${resolvedHref}`);\n    }\n    return <a {...anchorProps}>{children}</a>;\n  }\n\n  return (\n    <LinkStatusContext.Provider value={linkStatusValue}>\n      <a ref={setRefs} href={fullHref} onClick={handleClick} {...anchorProps}>\n        {children}\n      </a>\n    </LinkStatusContext.Provider>\n  );\n});\n\nexport default Link;\n"],"mappings":"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"}

package/dist/shims/metadata.d.ts

@@ -247,6 +247,31 @@ type MetadataMergeEntry = {
  * Shallow merge: later entries override earlier ones (per Next.js docs).
  */
 declare function mergeMetadata(metadataList: Metadata[]): Metadata;
+/**
+ * Post-process merged metadata to cross-fill openGraph and Twitter fields.
+ *
+ * Next.js runs this once after all layouts/pages and file-based metadata
+ * have been resolved. When openGraph exists, it auto-fills missing
+ * twitter:title/description/images from openGraph (falling back to root
+ * metadata title/description). Existing openGraph/twitter objects also inherit
+ * missing title/description from root metadata.
+ *
+ * Ported from Next.js:
+ * https://github.com/vercel/next.js/blob/canary/packages/next/src/lib/metadata/resolve-metadata.ts
+ */
+declare function postProcessMetadata(merged: Metadata): Metadata;
+/**
+ * Merge metadata from multiple sources (layouts + page).
+ *
+ * The list is ordered [rootLayout, nestedLayout, ..., page].
+ * Title template from layouts applies to the page title but NOT to
+ * the segment that defines the template itself. `title.absolute`
+ * skips all templates. `title.default` is the fallback when no
+ * child provides a title.
+ *
+ * For top-level keys, later entries override earlier ones. `other` custom meta
+ * tags are the exception: Next.js merges those across segments.
+ */
 declare function mergeMetadataEntries(entries: readonly MetadataMergeEntry[]): Metadata;
 /**
  * Resolve metadata from a module. Handles both static `metadata` export
@@ -265,5 +290,5 @@ declare function MetadataHead({
   metadata: Metadata;
 }): _$react_jsx_runtime0.JSX.Element;
 //#endregion
-export { DEFAULT_VIEWPORT, Metadata, MetadataHead, MetadataMergeEntry, Viewport, ViewportHead, mergeMetadata, mergeMetadataEntries, mergeViewport, resolveModuleMetadata, resolveModuleViewport };
+export { DEFAULT_VIEWPORT, Metadata, MetadataHead, MetadataMergeEntry, Viewport, ViewportHead, mergeMetadata, mergeMetadataEntries, mergeViewport, postProcessMetadata, resolveModuleMetadata, resolveModuleViewport };
 //# sourceMappingURL=metadata.d.ts.map

package/dist/shims/metadata.js

@@ -73,11 +73,95 @@ function ViewportHead({ viewport }) {
 * Shallow merge: later entries override earlier ones (per Next.js docs).
 */
 function mergeMetadata(metadataList) {
-	return mergeMetadataEntries(metadataList.map((metadata, index) => ({
+	return postProcessMetadata(mergeMetadataEntries(metadataList.map((metadata, index) => ({
 		isPage: index === metadataList.length - 1,
 		metadata
-	})));
+	}))));
 }
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof URL);
+}
+function isOtherMetadata(value) {
+	if (!isPlainObject(value)) return false;
+	return Object.values(value).every((item) => {
+		if (typeof item === "string") return true;
+		return Array.isArray(item) && item.every((nestedItem) => typeof nestedItem === "string");
+	});
+}
+/**
+* Extract a plain string title from a metadata title value.
+*/
+function resolveStringTitle(title) {
+	if (typeof title === "string") return title;
+	if (title && typeof title === "object") return title.absolute ?? title.default ?? void 0;
+}
+/**
+* Post-process merged metadata to cross-fill openGraph and Twitter fields.
+*
+* Next.js runs this once after all layouts/pages and file-based metadata
+* have been resolved. When openGraph exists, it auto-fills missing
+* twitter:title/description/images from openGraph (falling back to root
+* metadata title/description). Existing openGraph/twitter objects also inherit
+* missing title/description from root metadata.
+*
+* Ported from Next.js:
+* https://github.com/vercel/next.js/blob/canary/packages/next/src/lib/metadata/resolve-metadata.ts
+*/
+function postProcessMetadata(merged) {
+	const result = { ...merged };
+	const resolvedTitle = resolveStringTitle(result.title);
+	if (result.openGraph) {
+		const og = { ...result.openGraph };
+		if (!og.title && resolvedTitle) og.title = resolvedTitle;
+		if (!og.description && result.description) og.description = result.description;
+		result.openGraph = og;
+	}
+	if (result.openGraph) {
+		const autoFill = {};
+		const existingTwitter = result.twitter;
+		const hasTwTitle = existingTwitter ? Boolean(existingTwitter.title) : false;
+		const hasTwDescription = existingTwitter ? Boolean(existingTwitter.description) : false;
+		const hasTwImages = existingTwitter ? Object.prototype.hasOwnProperty.call(existingTwitter, "images") && Boolean(existingTwitter.images) : false;
+		if (!hasTwTitle) {
+			if (result.openGraph.title) autoFill.title = result.openGraph.title;
+			else if (resolvedTitle) autoFill.title = resolvedTitle;
+		}
+		if (!hasTwDescription) autoFill.description = result.openGraph.description || result.description || void 0;
+		if (!hasTwImages) autoFill.images = result.openGraph.images;
+		if (Object.keys(autoFill).length > 0) if (existingTwitter) result.twitter = {
+			...existingTwitter,
+			...autoFill
+		};
+		else result.twitter = autoFill;
+	}
+	if (result.twitter) {
+		const tw = { ...result.twitter };
+		if (!tw.title && resolvedTitle) tw.title = resolvedTitle;
+		if (!tw.description && result.description) tw.description = result.description;
+		result.twitter = tw;
+	}
+	if (result.twitter) {
+		const tw = { ...result.twitter };
+		if (!tw.card) {
+			const images = tw.images;
+			tw.card = (Array.isArray(images) ? images.length > 0 : Boolean(images)) ? "summary_large_image" : "summary";
+		}
+		result.twitter = tw;
+	}
+	return result;
+}
+/**
+* Merge metadata from multiple sources (layouts + page).
+*
+* The list is ordered [rootLayout, nestedLayout, ..., page].
+* Title template from layouts applies to the page title but NOT to
+* the segment that defines the template itself. `title.absolute`
+* skips all templates. `title.default` is the fallback when no
+* child provides a title.
+*
+* For top-level keys, later entries override earlier ones. `other` custom meta
+* tags are the exception: Next.js merges those across segments.
+*/
 function mergeMetadataEntries(entries) {
 	if (entries.length === 0) return {};
 	const merged = {};
@@ -89,7 +173,13 @@ function mergeMetadataEntries(entries) {
 		if (contributesTitle && !isPage && meta.title && typeof meta.title === "object" && meta.title.template) parentTemplate = meta.title.template;
 		for (const key of Object.keys(meta)) {
 			if (key === "title") continue;
-			merged[key] = meta[key];
+			const incoming = meta[key];
+			const existing = merged[key];
+			if (key === "other" && isOtherMetadata(existing) && isOtherMetadata(incoming)) merged.other = {
+				...existing,
+				...incoming
+			};
+			else merged[key] = incoming;
 		}
 		if (contributesTitle && meta.title !== void 0) merged.title = meta.title;
 	}
@@ -587,6 +677,6 @@ function MetadataHead({ metadata }) {
 	return /* @__PURE__ */ jsx(Fragment$1, { children: elements });
 }
 //#endregion
-export { DEFAULT_VIEWPORT, MetadataHead, ViewportHead, mergeMetadata, mergeMetadataEntries, mergeViewport, resolveModuleMetadata, resolveModuleViewport };
+export { DEFAULT_VIEWPORT, MetadataHead, ViewportHead, mergeMetadata, mergeMetadataEntries, mergeViewport, postProcessMetadata, resolveModuleMetadata, resolveModuleViewport };
 
 //# sourceMappingURL=metadata.js.map