vinext 0.0.51 → 0.0.53

package/dist/shims/image.js.map

@@ -1 +1 @@
-{"version":3,"file":"image.js","names":["UnpicImage"],"sources":["../../src/shims/image.tsx"],"sourcesContent":["\"use client\";\n\n/**\n * next/image shim\n *\n * Translates Next.js Image props to @unpic/react Image component.\n * @unpic/react auto-detects CDN from URL and uses native transforms.\n * For local images (relative paths), routes through `/_vinext/image`\n * for server-side optimization (resize, format negotiation, quality).\n *\n * Remote images are validated against `images.remotePatterns` and\n * `images.domains` from next.config.js. Unmatched URLs are blocked\n * in production and warn in development, matching Next.js behavior.\n */\nimport React, { forwardRef, useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport * as ReactDOM from \"react-dom\";\nimport { Image as UnpicImage } from \"@unpic/react\";\nimport { hasRemoteMatch, isPrivateIp, type RemotePattern } from \"./image-config.js\";\nimport { useMergedRef } from \"./use-merged-ref.js\";\n\nexport type StaticImageData = {\n  src: string;\n  height: number;\n  width: number;\n  blurDataURL?: string;\n};\n\n/**\n * Image config injected at build time via Vite define.\n * Serialized as JSON — parsed once at module level.\n */\nconst __imageRemotePatterns: RemotePattern[] = (() => {\n  try {\n    return JSON.parse(process.env.__VINEXT_IMAGE_REMOTE_PATTERNS ?? \"[]\");\n  } catch {\n    return [];\n  }\n})();\nconst __imageDomains: string[] = (() => {\n  try {\n    return JSON.parse(process.env.__VINEXT_IMAGE_DOMAINS ?? \"[]\");\n  } catch {\n    return [];\n  }\n})();\nconst __hasImageConfig = __imageRemotePatterns.length > 0 || __imageDomains.length > 0;\nconst __isDev = process.env.NODE_ENV !== \"production\";\nconst __imageDeviceSizes: number[] = (() => {\n  try {\n    return JSON.parse(\n      process.env.__VINEXT_IMAGE_DEVICE_SIZES ?? \"[640,750,828,1080,1200,1920,2048,3840]\",\n    );\n  } catch {\n    return [640, 750, 828, 1080, 1200, 1920, 2048, 3840];\n  }\n})();\n/**\n * Whether dangerouslyAllowSVG is enabled in next.config.js.\n * When false (default), .svg sources auto-skip the optimization endpoint\n * and are served directly, matching Next.js behavior.\n * When true, .svg sources are routed through the optimizer (served as-is\n * with security headers).\n */\nconst __dangerouslyAllowSVG = process.env.__VINEXT_IMAGE_DANGEROUSLY_ALLOW_SVG === \"true\";\n/**\n * Whether dangerouslyAllowLocalIP is enabled in next.config.js.\n * When false (default), remote image URLs with literal private-IP hostnames\n * are blocked to mitigate SSRF risk.\n */\nconst __dangerouslyAllowLocalIP = process.env.__VINEXT_IMAGE_DANGEROUSLY_ALLOW_LOCAL_IP === \"true\";\n\n/**\n * Validate that a remote URL is allowed by the configured remote patterns.\n * Returns true if the URL is allowed, false otherwise.\n *\n * When no remotePatterns/domains are configured, all remote URLs are allowed\n * (backwards-compatible — user hasn't opted into restriction).\n *\n * When patterns ARE configured, only matching URLs are allowed.\n * In development, non-matching URLs produce a console warning.\n * In production, non-matching URLs are blocked (src replaced with empty string).\n *\n * Private-IP hostnames are additionally rejected unless dangerouslyAllowLocalIP\n * is set, mirroring Next.js's fetchExternalImage guard.\n */\nfunction validateRemoteUrl(src: string): { allowed: boolean; reason?: string } {\n  let url: URL;\n  try {\n    url = new URL(src, \"http://n\");\n  } catch {\n    return { allowed: false, reason: `Invalid URL: ${src}` };\n  }\n\n  if (!__dangerouslyAllowLocalIP && isPrivateIp(url.hostname)) {\n    // Best-effort guard for literal-IP hostnames only. Domain names resolving\n    // to private IPs cannot be caught without server-side DNS resolution.\n    // See: Next.js fetchExternalImage in packages/next/src/server/image-optimizer.ts\n    return {\n      allowed: false,\n      reason: `Image URL \"${src}\" resolved to private IP. If this is expected and you understand SSRF risk, use images.dangerouslyAllowLocalIP = true to continue.`,\n    };\n  }\n\n  if (!__hasImageConfig) {\n    // No image config — allow everything (backwards-compatible)\n    return { allowed: true };\n  }\n\n  if (hasRemoteMatch(__imageDomains, __imageRemotePatterns, url)) {\n    return { allowed: true };\n  }\n\n  return {\n    allowed: false,\n    reason: `Image URL \"${src}\" is not configured in images.remotePatterns or images.domains in next.config.js. See: https://nextjs.org/docs/messages/next-image-unconfigured-host`,\n  };\n}\n\n/**\n * A version of useLayoutEffect that doesn't warn during SSR.\n * Do not rename this to \"isomorphic layout effect\". There is no such thing as\n * an isomorphic Layout Effect since there is no Layout on the server.\n * Ported from Next.js: https://github.com/vercel/next.js/pull/93209\n */\nconst useNonWarningLayoutEffect = typeof window === \"undefined\" ? useEffect : useLayoutEffect;\n\n/**\n * Create a synthetic React load event for replaying onLoad/onLoadingComplete\n * during hydration when the image already completed loading.\n *\n * This function creates a native Event(\"load\") via the DOM Event constructor\n * and must only be called in a browser context (client-side layout effect).\n * It mirrors the pattern used in Next.js `handleLoading`.\n */\nfunction createSyntheticLoadEvent(img: HTMLImageElement): React.SyntheticEvent<HTMLImageElement> {\n  const nativeEvent = new Event(\"load\");\n  Object.defineProperty(nativeEvent, \"target\", { writable: false, value: img });\n  let prevented = false;\n  let stopped = false;\n  return {\n    bubbles: nativeEvent.bubbles,\n    cancelable: nativeEvent.cancelable,\n    currentTarget: img,\n    defaultPrevented: false,\n    eventPhase: nativeEvent.eventPhase,\n    isTrusted: false,\n    nativeEvent,\n    target: img,\n    timeStamp: nativeEvent.timeStamp,\n    type: \"load\",\n    isDefaultPrevented: () => prevented,\n    isPropagationStopped: () => stopped,\n    persist: () => {},\n    preventDefault: () => {\n      prevented = true;\n      nativeEvent.preventDefault();\n    },\n    stopPropagation: () => {\n      stopped = true;\n      nativeEvent.stopPropagation();\n    },\n  };\n}\n\ntype ImageProps = {\n  src: string | StaticImageData;\n  alt: string;\n  width?: number;\n  height?: number;\n  fill?: boolean;\n  preload?: boolean;\n  priority?: boolean;\n  quality?: number;\n  placeholder?: \"blur\" | \"empty\";\n  blurDataURL?: string;\n  loader?: (params: { src: string; width: number; quality?: number }) => string;\n  sizes?: string;\n  className?: string;\n  style?: React.CSSProperties;\n  onLoad?: React.ReactEventHandler<HTMLImageElement>;\n  /** @deprecated Use onLoad instead. Still supported for migration compat. */\n  onLoadingComplete?: (img: HTMLImageElement) => void;\n  onError?: React.ReactEventHandler<HTMLImageElement>;\n  onClick?: React.MouseEventHandler<HTMLImageElement>;\n  id?: string;\n  // Accept and ignore Next.js-specific props that don't apply\n  unoptimized?: boolean;\n  overrideSrc?: string;\n  loading?: \"lazy\" | \"eager\";\n};\n\n/**\n * Sanitize a blurDataURL to prevent CSS injection.\n *\n * A crafted data URL containing `)` can break out of the `url()` CSS function,\n * allowing injection of arbitrary CSS properties or rules. Characters like `{`,\n * `}`, and `\\` can also assist in crafting injection payloads.\n *\n * This validates the URL starts with `data:image/` and rejects characters that\n * could escape the `url()` context. Semicolons are allowed since they're part\n * of valid data URLs (`data:image/png;base64,...`) and harmless inside `url()`.\n *\n * Returns undefined for invalid URLs, which causes the blur placeholder to be\n * skipped gracefully.\n */\nfunction sanitizeBlurDataURL(url: string): string | undefined {\n  // Must be a data: image URL\n  if (!url.startsWith(\"data:image/\")) return undefined;\n  // Reject characters that can break out of CSS url():\n  //   ) - closes url()\n  //   ( - could open nested functions\n  //   { } - CSS rule boundaries\n  //   \\ - CSS escape sequences\n  //   newlines - break CSS parsing\n  if (/[)(}{\\\\'\"\\n\\r]/.test(url)) return undefined;\n  return url;\n}\n\n/**\n * Determine if a src is a remote URL (CDN-optimizable) or local.\n */\nfunction isRemoteUrl(src: string): boolean {\n  return src.startsWith(\"http://\") || src.startsWith(\"https://\") || src.startsWith(\"//\");\n}\n\nfunction getFillStyle(\n  style?: React.CSSProperties,\n  backgroundStyle?: React.CSSProperties,\n): React.CSSProperties {\n  return {\n    position: \"absolute\",\n    inset: 0,\n    width: \"100%\",\n    height: \"100%\",\n    objectFit: \"cover\",\n    ...backgroundStyle,\n    ...style,\n  };\n}\n\n/**\n * Resolve src, width, height, blurDataURL from Image props (string or StaticImageData).\n * Shared by the Image component and getImageProps to keep behavior in sync.\n */\nfunction resolveImageSource(v: {\n  src: string | StaticImageData;\n  width?: number;\n  height?: number;\n  blurDataURL?: string;\n}): { src: string; width?: number; height?: number; blurDataURL?: string } {\n  const src = typeof v.src === \"string\" ? v.src : v.src.src;\n  const imgWidth = v.width ?? (typeof v.src === \"object\" ? v.src.width : undefined);\n  const imgHeight = v.height ?? (typeof v.src === \"object\" ? v.src.height : undefined);\n  const imgBlurDataURL =\n    v.blurDataURL ?? (typeof v.src === \"object\" ? v.src.blurDataURL : undefined);\n  return { src, width: imgWidth, height: imgHeight, blurDataURL: imgBlurDataURL };\n}\n\n/**\n * Responsive image widths matching Next.js's device sizes config.\n * These are the breakpoints used for srcSet generation.\n * Configurable via `images.deviceSizes` in next.config.js.\n */\nconst RESPONSIVE_WIDTHS = __imageDeviceSizes;\n\n/**\n * Build a `/_vinext/image` optimization URL.\n *\n * In production (Cloudflare Workers), the worker intercepts this path and uses\n * the Images binding to resize/transcode on the fly. In dev, the Vite dev\n * server handles it as a passthrough (serves the original file).\n */\nexport function imageOptimizationUrl(src: string, width: number, quality: number = 75): string {\n  return `/_vinext/image?url=${encodeURIComponent(src)}&w=${width}&q=${quality}`;\n}\n\nfunction preloadImageResource(input: {\n  shouldPreload: boolean;\n  src: string;\n  srcSet?: string;\n  sizes?: string;\n  fetchPriority?: ReactDOM.PreloadOptions[\"fetchPriority\"];\n}): void {\n  if (!input.shouldPreload) return;\n  if (typeof ReactDOM.preload !== \"function\") return;\n  ReactDOM.preload(input.src, {\n    as: \"image\",\n    imageSrcSet: input.srcSet,\n    imageSizes: input.sizes,\n    fetchPriority: input.fetchPriority,\n  });\n}\n\n/**\n * Generate a srcSet string for responsive images.\n *\n * Each width points to the `/_vinext/image` optimization endpoint so the\n * server can resize and transcode the image. Only includes widths that are\n * <= 2x the original image width to avoid pointless upscaling.\n */\nfunction generateSrcSet(src: string, originalWidth: number, quality: number = 75): string {\n  const widths = RESPONSIVE_WIDTHS.filter((w) => w <= originalWidth * 2);\n  if (widths.length === 0)\n    return `${imageOptimizationUrl(src, originalWidth, quality)} ${originalWidth}w`;\n  return widths.map((w) => `${imageOptimizationUrl(src, w, quality)} ${w}w`).join(\", \");\n}\n\nconst Image = forwardRef<HTMLImageElement, ImageProps>(function Image(\n  {\n    src: srcProp,\n    alt,\n    width,\n    height,\n    fill,\n    preload,\n    priority,\n    quality,\n    placeholder,\n    blurDataURL,\n    loader,\n    sizes,\n    className,\n    style,\n    onLoad,\n    onLoadingComplete,\n    onError,\n    unoptimized: _unoptimized,\n    overrideSrc: _overrideSrc,\n    loading,\n    ...rest\n  },\n  ref,\n) {\n  // Dedup refs: ensure onLoad and onError fire at most once per src per mount.\n  // Matches Next.js behavior — prevents double-firing from React re-renders,\n  // strict-mode double-invocation, or state updates inside the handler itself.\n  // Ported from Next.js: https://github.com/vercel/next.js/pull/93209\n  const lastLoadedSrcRef = useRef<string | undefined>(undefined);\n  const lastErrorSrcRef = useRef<string | undefined>(undefined);\n\n  // Hydration-level onError replay: when an image fails to load during SSR\n  // streaming or initial HTML parse (before React hydrates), the native browser\n  // error event is lost. Re-trigger it via `img.src = img.src` in a layout\n  // effect once hydration completes, mirroring the upstream Next.js fix.\n  // Ported from Next.js: https://github.com/vercel/next.js/pull/93209\n  const didInsertRef = useRef(false);\n  const imgElementRef = useRef<HTMLImageElement | null>(null);\n\n  // Merge forwarded ref with internal img ref for layout effect access.\n  const mergedRef = useMergedRef(ref, imgElementRef);\n\n  // Stable refs for onLoad / onError / onLoadingComplete so the layout effect\n  // does not re-run (and re-assign img.src) when handler identity changes.\n  // Ported from Next.js: https://github.com/vercel/next.js/pull/93209\n  //\n  // IMPORTANT: The useRef+useEffect sync pattern has a subtle timing gap:\n  // during the first render, onLoadRef.current holds the initial value from\n  // useRef(onLoad), and the useEffect to sync it runs AFTER the layout effect.\n  // This means on first mount the layout effect reads the correct initial\n  // value (passed to useRef). If someone changes useRef(onLoad) to\n  // useRef(undefined), the layout effect would read undefined on first mount.\n  const onLoadRef = useRef(onLoad);\n  useEffect(() => {\n    onLoadRef.current = onLoad;\n  }, [onLoad]);\n  const onErrorRef = useRef(onError);\n  useEffect(() => {\n    onErrorRef.current = onError;\n  }, [onError]);\n  const onLoadingCompleteRef = useRef(onLoadingComplete);\n  useEffect(() => {\n    onLoadingCompleteRef.current = onLoadingComplete;\n  }, [onLoadingComplete]);\n\n  const {\n    src,\n    width: imgWidth,\n    height: imgHeight,\n    blurDataURL: imgBlurDataURL,\n  } = resolveImageSource({ src: srcProp, width, height, blurDataURL });\n  const shouldPreload = preload === true || priority === true;\n  const priorityFetchPriority = priority ? \"high\" : undefined;\n  const imageLoading = priority ? \"eager\" : shouldPreload ? loading : (loading ?? \"lazy\");\n\n  const [completedBlurSrc, setCompletedBlurSrc] = useState<string | undefined>(undefined);\n  const blurComplete = completedBlurSrc === src;\n\n  const markBlurComplete = () => {\n    if (placeholder !== \"blur\") return;\n    setCompletedBlurSrc((current) => (current === src ? current : src));\n  };\n\n  useNonWarningLayoutEffect(() => {\n    if (!didInsertRef.current && imgElementRef.current !== null) {\n      const img = imgElementRef.current;\n      // Replay error events lost during SSR/hydration.\n      if (onErrorRef.current) {\n        // eslint-disable-next-line no-self-assign\n        img.src = img.src;\n      }\n      // Replay onLoad for images that completed loading before React hydrated\n      // (e.g. SSR streaming where the image arrives and renders before hydration\n      // finishes). Without this, onLoad never fires for those images.\n      //\n      // img.complete is true for both successfully-loaded and errored images\n      // (the HTML spec defines complete as true when the browser finished\n      // fetching, regardless of outcome). We must check naturalWidth > 0 to\n      // distinguish success from error — a failed image has naturalWidth === 0.\n      // Ported from Next.js: https://github.com/vercel/next.js/pull/93209\n      if (img.complete && img.naturalWidth > 0) {\n        markBlurComplete();\n        const currentOnLoad = onLoadRef.current;\n        const currentOnLoadingComplete = onLoadingCompleteRef.current;\n        if (currentOnLoad || currentOnLoadingComplete) {\n          // Dedup — fire at most once per src per mount, matching onLoad dedup\n          if (lastLoadedSrcRef.current !== src) {\n            lastLoadedSrcRef.current = src;\n            // Create a synthetic React event with the expected shape.\n            // next/image uses a similar pattern in `handleLoading`.\n            const syntheticEvent = createSyntheticLoadEvent(img);\n            currentOnLoad?.(syntheticEvent);\n            currentOnLoadingComplete?.(img);\n          }\n        }\n      }\n      didInsertRef.current = true;\n    }\n  }, [placeholder, sizes, _unoptimized]);\n\n  // Wire onLoadingComplete (deprecated) into onLoad — matches Next.js behavior.\n  // onLoad fires first, then onLoadingComplete receives the HTMLImageElement.\n  const handleLoad = onLoadingComplete\n    ? (e: React.SyntheticEvent<HTMLImageElement>) => {\n        if (lastLoadedSrcRef.current === src) return;\n        lastLoadedSrcRef.current = src;\n        markBlurComplete();\n        onLoad?.(e);\n        onLoadingComplete(e.currentTarget);\n      }\n    : onLoad\n      ? (e: React.SyntheticEvent<HTMLImageElement>) => {\n          if (lastLoadedSrcRef.current === src) return;\n          lastLoadedSrcRef.current = src;\n          markBlurComplete();\n          onLoad(e);\n        }\n      : placeholder === \"blur\"\n        ? () => {\n            if (lastLoadedSrcRef.current === src) return;\n            lastLoadedSrcRef.current = src;\n            markBlurComplete();\n          }\n        : undefined;\n\n  const handleError = onError\n    ? (e: React.SyntheticEvent<HTMLImageElement>) => {\n        if (lastErrorSrcRef.current === src) return;\n        lastErrorSrcRef.current = src;\n        markBlurComplete();\n        onError(e);\n      }\n    : placeholder === \"blur\"\n      ? () => {\n          if (lastErrorSrcRef.current === src) return;\n          lastErrorSrcRef.current = src;\n          markBlurComplete();\n        }\n      : undefined;\n\n  // If a custom loader is provided, use basic img with loader URL\n  if (loader) {\n    const resolvedSrc = loader({ src, width: imgWidth ?? 0, quality: quality ?? 75 });\n    preloadImageResource({\n      shouldPreload,\n      src: resolvedSrc,\n      sizes,\n      fetchPriority: priorityFetchPriority,\n    });\n    return (\n      <img\n        ref={mergedRef}\n        src={resolvedSrc}\n        alt={alt}\n        width={fill ? undefined : imgWidth}\n        height={fill ? undefined : imgHeight}\n        loading={imageLoading}\n        decoding=\"async\"\n        sizes={sizes}\n        className={className}\n        onLoad={handleLoad}\n        onError={handleError}\n        style={fill ? getFillStyle(style) : style}\n        {...rest}\n      />\n    );\n  }\n\n  // For remote URLs, validate against remotePatterns. Non-fill images use\n  // @unpic/react for CDN URL transforms; fill uses a plain img so the DOM\n  // element keeps Next.js's absolute-positioned fill contract.\n  if (isRemoteUrl(src)) {\n    const validation = validateRemoteUrl(src);\n    if (!validation.allowed) {\n      if (__isDev) {\n        console.warn(`[next/image] ${validation.reason}`);\n        // In dev, render the image but with a warning — matches Next.js dev behavior\n      } else {\n        // In production, block the image entirely\n        console.error(`[next/image] ${validation.reason}`);\n        return null;\n      }\n    }\n\n    const sanitizedBlur = imgBlurDataURL ? sanitizeBlurDataURL(imgBlurDataURL) : undefined;\n    const showBlur = !blurComplete && placeholder === \"blur\" && sanitizedBlur;\n    const blurStyle = showBlur\n      ? {\n          backgroundImage: `url(${sanitizedBlur})`,\n          backgroundSize: \"cover\",\n          backgroundRepeat: \"no-repeat\",\n          backgroundPosition: \"center\",\n        }\n      : undefined;\n    const bg = showBlur ? `url(${sanitizedBlur})` : undefined;\n\n    if (fill) {\n      const fillSizes = sizes ?? \"100vw\";\n      preloadImageResource({\n        shouldPreload,\n        src,\n        sizes: fillSizes,\n        fetchPriority: priorityFetchPriority,\n      });\n      return (\n        <img\n          ref={mergedRef}\n          src={src}\n          alt={alt}\n          // `priority` is a Next.js concept — translate it to HTML attributes so\n          // it is never forwarded to the DOM as a non-boolean attribute, which\n          // would trigger React's \"Received `true` for a non-boolean attribute\"\n          // warning.\n          loading={imageLoading}\n          fetchPriority={priorityFetchPriority}\n          decoding=\"async\"\n          sizes={fillSizes}\n          className={className}\n          data-nimg=\"fill\"\n          onLoad={handleLoad}\n          onError={handleError}\n          style={getFillStyle(style, blurStyle)}\n          {...rest}\n        />\n      );\n    }\n    // constrained layout requires width+height or aspectRatio\n    if (imgWidth && imgHeight) {\n      // @unpic/react forwards additional image props through transformProps and\n      // merges `style` with generated layout styles at runtime, but its public\n      // React type omits `style`.\n      const unpicRuntimeStyleProps: { style?: React.CSSProperties } = { style };\n      preloadImageResource({\n        shouldPreload,\n        src,\n        sizes,\n        fetchPriority: priorityFetchPriority,\n      });\n      return (\n        <UnpicImage\n          src={src}\n          alt={alt}\n          width={imgWidth}\n          height={imgHeight}\n          layout=\"constrained\"\n          // Same translation as above — never pass `priority` to the DOM.\n          loading={imageLoading}\n          fetchPriority={priorityFetchPriority}\n          sizes={sizes}\n          className={className}\n          {...unpicRuntimeStyleProps}\n          background={bg}\n          onLoad={handleLoad}\n          onError={handleError}\n          ref={mergedRef}\n        />\n      );\n    }\n    // Fall through to basic <img> if dimensions not provided\n    // (unpic requires them for constrained layout)\n  }\n\n  // Route local images through the /_vinext/image optimization endpoint.\n  // In production on Cloudflare Workers, this resizes and transcodes via\n  // the Images binding. In dev, it serves the original file as a passthrough.\n  // When `unoptimized` is true, bypass the endpoint entirely (Next.js compat).\n  // SVG sources auto-skip unless dangerouslyAllowSVG is enabled, matching\n  // Next.js behavior where .svg triggers unoptimized=true by default.\n  const imgQuality = quality ?? 75;\n  const isSvg = src.endsWith(\".svg\");\n  const skipOptimization = _unoptimized === true || (isSvg && !__dangerouslyAllowSVG);\n\n  // Build srcSet for responsive local images (common breakpoints).\n  // Each entry points to /_vinext/image with the appropriate width.\n  const srcSet =\n    imgWidth && !fill && !skipOptimization\n      ? generateSrcSet(src, imgWidth, imgQuality)\n      : imgWidth && !fill\n        ? RESPONSIVE_WIDTHS.filter((w) => w <= imgWidth * 2)\n            .map((w) => `${src} ${w}w`)\n            .join(\", \") || `${src} ${imgWidth}w`\n        : undefined;\n\n  // The main `src` also goes through the optimization endpoint. Use the\n  // declared width (or the first responsive width as fallback).\n  const optimizedSrc = skipOptimization\n    ? src\n    : imgWidth\n      ? imageOptimizationUrl(src, imgWidth, imgQuality)\n      : imageOptimizationUrl(src, RESPONSIVE_WIDTHS[0], imgQuality);\n\n  // Blur placeholder: show a low-quality background while the image loads.\n  // Sanitize blurDataURL to prevent CSS injection via crafted data URLs.\n  const sanitizedLocalBlur = imgBlurDataURL ? sanitizeBlurDataURL(imgBlurDataURL) : undefined;\n  const blurStyle =\n    !blurComplete && placeholder === \"blur\" && sanitizedLocalBlur\n      ? {\n          backgroundImage: `url(${sanitizedLocalBlur})`,\n          backgroundSize: \"cover\",\n          backgroundRepeat: \"no-repeat\",\n          backgroundPosition: \"center\",\n        }\n      : undefined;\n\n  const imageSizes = sizes ?? (fill ? \"100vw\" : undefined);\n  preloadImageResource({\n    shouldPreload,\n    src: optimizedSrc,\n    srcSet,\n    sizes: imageSizes,\n    fetchPriority: priorityFetchPriority,\n  });\n\n  // For local images, render a standard <img> tag with srcSet and blur support.\n  // The src and srcSet point to the /_vinext/image optimization endpoint.\n  return (\n    <img\n      ref={mergedRef}\n      src={optimizedSrc}\n      alt={alt}\n      width={fill ? undefined : imgWidth}\n      height={fill ? undefined : imgHeight}\n      loading={imageLoading}\n      fetchPriority={priorityFetchPriority}\n      decoding=\"async\"\n      srcSet={srcSet}\n      sizes={imageSizes}\n      className={className}\n      data-nimg={fill ? \"fill\" : \"1\"}\n      onLoad={handleLoad}\n      onError={handleError}\n      style={fill ? getFillStyle(style, blurStyle) : { ...blurStyle, ...style }}\n      {...rest}\n    />\n  );\n});\n\n/**\n * getImageProps — for advanced use cases (picture elements, background images).\n * Returns the props that would be passed to the underlying <img> element.\n */\nexport function getImageProps(props: ImageProps): {\n  props: React.ImgHTMLAttributes<HTMLImageElement>;\n} {\n  const {\n    src: srcProp,\n    alt,\n    width,\n    height,\n    fill,\n    preload: _preload,\n    priority,\n    quality: _quality,\n    placeholder,\n    blurDataURL: blurDataURLProp,\n    loader,\n    sizes,\n    className,\n    style,\n    onLoad: _onLoad,\n    onLoadingComplete: _onLoadingComplete,\n    unoptimized: _unoptimized,\n    overrideSrc: _overrideSrc,\n    loading,\n    ...rest\n  } = props;\n\n  const {\n    src,\n    width: imgWidth,\n    height: imgHeight,\n    blurDataURL: imgBlurDataURL,\n  } = resolveImageSource({ src: srcProp, width, height, blurDataURL: blurDataURLProp });\n  const shouldPreload = _preload === true || priority === true;\n\n  // Validate remote URLs against configured patterns\n  let blockedInProd = false;\n  if (isRemoteUrl(src)) {\n    const validation = validateRemoteUrl(src);\n    if (!validation.allowed) {\n      if (__isDev) {\n        console.warn(`[next/image] ${validation.reason}`);\n      } else {\n        console.error(`[next/image] ${validation.reason}`);\n        blockedInProd = true;\n      }\n    }\n  }\n\n  // Resolve src through custom loader if provided\n  const imgQuality = _quality ?? 75;\n  const resolvedSrc = blockedInProd\n    ? \"\"\n    : loader\n      ? loader({ src, width: imgWidth ?? 0, quality: imgQuality })\n      : src;\n\n  // For local images (no loader, not remote), route through optimization endpoint.\n  // When `unoptimized` is true, bypass the endpoint entirely (Next.js compat).\n  // SVG sources auto-skip unless dangerouslyAllowSVG is enabled.\n  const isSvg = resolvedSrc.endsWith(\".svg\");\n  const skipOpt =\n    _unoptimized === true ||\n    (isSvg && !__dangerouslyAllowSVG) ||\n    blockedInProd ||\n    !!loader ||\n    isRemoteUrl(resolvedSrc);\n  const optimizedSrc = skipOpt\n    ? resolvedSrc\n    : imgWidth\n      ? imageOptimizationUrl(resolvedSrc, imgWidth, imgQuality)\n      : imageOptimizationUrl(resolvedSrc, RESPONSIVE_WIDTHS[0], imgQuality);\n\n  // Build srcSet for local images — each width points to /_vinext/image\n  const srcSet =\n    imgWidth && !fill && !isRemoteUrl(resolvedSrc) && !loader && !skipOpt\n      ? generateSrcSet(resolvedSrc, imgWidth, imgQuality)\n      : undefined;\n\n  // Blur placeholder styles — sanitize to prevent CSS injection\n  const sanitizedBlurURL = imgBlurDataURL ? sanitizeBlurDataURL(imgBlurDataURL) : undefined;\n  const blurStyle =\n    placeholder === \"blur\" && sanitizedBlurURL\n      ? {\n          backgroundImage: `url(${sanitizedBlurURL})`,\n          backgroundSize: \"cover\",\n          backgroundRepeat: \"no-repeat\" as const,\n          backgroundPosition: \"center\" as const,\n        }\n      : undefined;\n\n  return {\n    props: {\n      src: optimizedSrc,\n      alt,\n      width: fill ? undefined : imgWidth,\n      height: fill ? undefined : imgHeight,\n      loading: priority ? \"eager\" : shouldPreload ? loading : (loading ?? \"lazy\"),\n      fetchPriority: priority ? (\"high\" as const) : undefined,\n      decoding: \"async\" as const,\n      srcSet,\n      sizes: sizes ?? (fill ? \"100vw\" : undefined),\n      className,\n      \"data-nimg\": fill ? \"fill\" : \"1\",\n      style: fill ? getFillStyle(style, blurStyle) : { ...blurStyle, ...style },\n      ...rest,\n    } as React.ImgHTMLAttributes<HTMLImageElement>,\n  };\n}\n\nexport default Image;\n"],"mappings":"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"}
+{"version":3,"file":"image.js","names":["UnpicImage"],"sources":["../../src/shims/image.tsx"],"sourcesContent":["\"use client\";\n\n/**\n * next/image shim\n *\n * Translates Next.js Image props to @unpic/react Image component.\n * @unpic/react auto-detects CDN from URL and uses native transforms.\n * For local images (relative paths), routes through `/_next/image`\n * for server-side optimization (resize, format negotiation, quality).\n *\n * Remote images are validated against `images.remotePatterns` and\n * `images.domains` from next.config.js. Unmatched URLs are blocked\n * in production and warn in development, matching Next.js behavior.\n */\nimport React, { forwardRef, useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport * as ReactDOM from \"react-dom\";\nimport { Image as UnpicImage } from \"@unpic/react\";\nimport { hasRemoteMatch, isPrivateIp, type RemotePattern } from \"./image-config.js\";\nimport { useMergedRef } from \"./use-merged-ref.js\";\n\nexport type StaticImageData = {\n  src: string;\n  height: number;\n  width: number;\n  blurDataURL?: string;\n};\n\n/**\n * Image config injected at build time via Vite define.\n * Serialized as JSON — parsed once at module level.\n */\nconst __imageRemotePatterns: RemotePattern[] = (() => {\n  try {\n    return JSON.parse(process.env.__VINEXT_IMAGE_REMOTE_PATTERNS ?? \"[]\");\n  } catch {\n    return [];\n  }\n})();\nconst __imageDomains: string[] = (() => {\n  try {\n    return JSON.parse(process.env.__VINEXT_IMAGE_DOMAINS ?? \"[]\");\n  } catch {\n    return [];\n  }\n})();\nconst __hasImageConfig = __imageRemotePatterns.length > 0 || __imageDomains.length > 0;\nconst __isDev = process.env.NODE_ENV !== \"production\";\nconst __imageDeviceSizes: number[] = (() => {\n  try {\n    return JSON.parse(\n      process.env.__VINEXT_IMAGE_DEVICE_SIZES ?? \"[640,750,828,1080,1200,1920,2048,3840]\",\n    );\n  } catch {\n    return [640, 750, 828, 1080, 1200, 1920, 2048, 3840];\n  }\n})();\n/**\n * Whether dangerouslyAllowSVG is enabled in next.config.js.\n * When false (default), .svg sources auto-skip the optimization endpoint\n * and are served directly, matching Next.js behavior.\n * When true, .svg sources are routed through the optimizer (served as-is\n * with security headers).\n */\nconst __dangerouslyAllowSVG = process.env.__VINEXT_IMAGE_DANGEROUSLY_ALLOW_SVG === \"true\";\n/**\n * Whether dangerouslyAllowLocalIP is enabled in next.config.js.\n * When false (default), remote image URLs with literal private-IP hostnames\n * are blocked to mitigate SSRF risk.\n */\nconst __dangerouslyAllowLocalIP = process.env.__VINEXT_IMAGE_DANGEROUSLY_ALLOW_LOCAL_IP === \"true\";\n\n/**\n * Validate that a remote URL is allowed by the configured remote patterns.\n * Returns true if the URL is allowed, false otherwise.\n *\n * When no remotePatterns/domains are configured, all remote URLs are allowed\n * (backwards-compatible — user hasn't opted into restriction).\n *\n * When patterns ARE configured, only matching URLs are allowed.\n * In development, non-matching URLs produce a console warning.\n * In production, non-matching URLs are blocked (src replaced with empty string).\n *\n * Private-IP hostnames are additionally rejected unless dangerouslyAllowLocalIP\n * is set, mirroring Next.js's fetchExternalImage guard.\n */\nfunction validateRemoteUrl(src: string): { allowed: boolean; reason?: string } {\n  let url: URL;\n  try {\n    url = new URL(src, \"http://n\");\n  } catch {\n    return { allowed: false, reason: `Invalid URL: ${src}` };\n  }\n\n  if (!__dangerouslyAllowLocalIP && isPrivateIp(url.hostname)) {\n    // Best-effort guard for literal-IP hostnames only. Domain names resolving\n    // to private IPs cannot be caught without server-side DNS resolution.\n    // See: Next.js fetchExternalImage in packages/next/src/server/image-optimizer.ts\n    return {\n      allowed: false,\n      reason: `Image URL \"${src}\" resolved to private IP. If this is expected and you understand SSRF risk, use images.dangerouslyAllowLocalIP = true to continue.`,\n    };\n  }\n\n  if (!__hasImageConfig) {\n    // No image config — allow everything (backwards-compatible)\n    return { allowed: true };\n  }\n\n  if (hasRemoteMatch(__imageDomains, __imageRemotePatterns, url)) {\n    return { allowed: true };\n  }\n\n  return {\n    allowed: false,\n    reason: `Image URL \"${src}\" is not configured in images.remotePatterns or images.domains in next.config.js. See: https://nextjs.org/docs/messages/next-image-unconfigured-host`,\n  };\n}\n\n/**\n * A version of useLayoutEffect that doesn't warn during SSR.\n * Do not rename this to \"isomorphic layout effect\". There is no such thing as\n * an isomorphic Layout Effect since there is no Layout on the server.\n * Ported from Next.js: https://github.com/vercel/next.js/pull/93209\n */\nconst useNonWarningLayoutEffect = typeof window === \"undefined\" ? useEffect : useLayoutEffect;\n\n/**\n * Create a synthetic React load event for replaying onLoad/onLoadingComplete\n * during hydration when the image already completed loading.\n *\n * This function creates a native Event(\"load\") via the DOM Event constructor\n * and must only be called in a browser context (client-side layout effect).\n * It mirrors the pattern used in Next.js `handleLoading`.\n */\nfunction createSyntheticLoadEvent(img: HTMLImageElement): React.SyntheticEvent<HTMLImageElement> {\n  const nativeEvent = new Event(\"load\");\n  Object.defineProperty(nativeEvent, \"target\", { writable: false, value: img });\n  let prevented = false;\n  let stopped = false;\n  return {\n    bubbles: nativeEvent.bubbles,\n    cancelable: nativeEvent.cancelable,\n    currentTarget: img,\n    defaultPrevented: false,\n    eventPhase: nativeEvent.eventPhase,\n    isTrusted: false,\n    nativeEvent,\n    target: img,\n    timeStamp: nativeEvent.timeStamp,\n    type: \"load\",\n    isDefaultPrevented: () => prevented,\n    isPropagationStopped: () => stopped,\n    persist: () => {},\n    preventDefault: () => {\n      prevented = true;\n      nativeEvent.preventDefault();\n    },\n    stopPropagation: () => {\n      stopped = true;\n      nativeEvent.stopPropagation();\n    },\n  };\n}\n\ntype ImageProps = {\n  src: string | StaticImageData;\n  alt: string;\n  width?: number;\n  height?: number;\n  fill?: boolean;\n  preload?: boolean;\n  priority?: boolean;\n  quality?: number;\n  placeholder?: \"blur\" | \"empty\";\n  blurDataURL?: string;\n  loader?: (params: { src: string; width: number; quality?: number }) => string;\n  sizes?: string;\n  className?: string;\n  style?: React.CSSProperties;\n  onLoad?: React.ReactEventHandler<HTMLImageElement>;\n  /** @deprecated Use onLoad instead. Still supported for migration compat. */\n  onLoadingComplete?: (img: HTMLImageElement) => void;\n  onError?: React.ReactEventHandler<HTMLImageElement>;\n  onClick?: React.MouseEventHandler<HTMLImageElement>;\n  id?: string;\n  // Accept and ignore Next.js-specific props that don't apply\n  unoptimized?: boolean;\n  overrideSrc?: string;\n  loading?: \"lazy\" | \"eager\";\n};\n\n/**\n * Sanitize a blurDataURL to prevent CSS injection.\n *\n * A crafted data URL containing `)` can break out of the `url()` CSS function,\n * allowing injection of arbitrary CSS properties or rules. Characters like `{`,\n * `}`, and `\\` can also assist in crafting injection payloads.\n *\n * This validates the URL starts with `data:image/` and rejects characters that\n * could escape the `url()` context. Semicolons are allowed since they're part\n * of valid data URLs (`data:image/png;base64,...`) and harmless inside `url()`.\n *\n * Returns undefined for invalid URLs, which causes the blur placeholder to be\n * skipped gracefully.\n */\nfunction sanitizeBlurDataURL(url: string): string | undefined {\n  // Must be a data: image URL\n  if (!url.startsWith(\"data:image/\")) return undefined;\n  // Reject characters that can break out of CSS url():\n  //   ) - closes url()\n  //   ( - could open nested functions\n  //   { } - CSS rule boundaries\n  //   \\ - CSS escape sequences\n  //   newlines - break CSS parsing\n  if (/[)(}{\\\\'\"\\n\\r]/.test(url)) return undefined;\n  return url;\n}\n\n/**\n * Determine if a src is a remote URL (CDN-optimizable) or local.\n */\nfunction isRemoteUrl(src: string): boolean {\n  return src.startsWith(\"http://\") || src.startsWith(\"https://\") || src.startsWith(\"//\");\n}\n\nfunction getFillStyle(\n  style?: React.CSSProperties,\n  backgroundStyle?: React.CSSProperties,\n): React.CSSProperties {\n  return {\n    position: \"absolute\",\n    inset: 0,\n    width: \"100%\",\n    height: \"100%\",\n    objectFit: \"cover\",\n    ...backgroundStyle,\n    ...style,\n  };\n}\n\n/**\n * Resolve src, width, height, blurDataURL from Image props (string or StaticImageData).\n * Shared by the Image component and getImageProps to keep behavior in sync.\n */\nfunction resolveImageSource(v: {\n  src: string | StaticImageData;\n  width?: number;\n  height?: number;\n  blurDataURL?: string;\n}): { src: string; width?: number; height?: number; blurDataURL?: string } {\n  const src = typeof v.src === \"string\" ? v.src : v.src.src;\n  const imgWidth = v.width ?? (typeof v.src === \"object\" ? v.src.width : undefined);\n  const imgHeight = v.height ?? (typeof v.src === \"object\" ? v.src.height : undefined);\n  const imgBlurDataURL =\n    v.blurDataURL ?? (typeof v.src === \"object\" ? v.src.blurDataURL : undefined);\n  return { src, width: imgWidth, height: imgHeight, blurDataURL: imgBlurDataURL };\n}\n\n/**\n * Responsive image widths matching Next.js's device sizes config.\n * These are the breakpoints used for srcSet generation.\n * Configurable via `images.deviceSizes` in next.config.js.\n */\nconst RESPONSIVE_WIDTHS = __imageDeviceSizes;\n\n/**\n * Build a `/_next/image` optimization URL.\n *\n * In production (Cloudflare Workers), the worker intercepts this path and uses\n * the Images binding to resize/transcode on the fly. In dev, the Vite dev\n * server handles it as a passthrough (serves the original file).\n */\nexport function imageOptimizationUrl(src: string, width: number, quality: number = 75): string {\n  return `/_next/image?url=${encodeURIComponent(src)}&w=${width}&q=${quality}`;\n}\n\nfunction preloadImageResource(input: {\n  shouldPreload: boolean;\n  src: string;\n  srcSet?: string;\n  sizes?: string;\n  fetchPriority?: ReactDOM.PreloadOptions[\"fetchPriority\"];\n}): void {\n  if (!input.shouldPreload) return;\n  if (typeof ReactDOM.preload !== \"function\") return;\n  ReactDOM.preload(input.src, {\n    as: \"image\",\n    imageSrcSet: input.srcSet,\n    imageSizes: input.sizes,\n    fetchPriority: input.fetchPriority,\n  });\n}\n\n/**\n * Generate a srcSet string for responsive images.\n *\n * Each width points to the `/_next/image` optimization endpoint so the\n * server can resize and transcode the image. Only includes widths that are\n * <= 2x the original image width to avoid pointless upscaling.\n */\nfunction generateSrcSet(src: string, originalWidth: number, quality: number = 75): string {\n  const widths = RESPONSIVE_WIDTHS.filter((w) => w <= originalWidth * 2);\n  if (widths.length === 0)\n    return `${imageOptimizationUrl(src, originalWidth, quality)} ${originalWidth}w`;\n  return widths.map((w) => `${imageOptimizationUrl(src, w, quality)} ${w}w`).join(\", \");\n}\n\nconst Image = forwardRef<HTMLImageElement, ImageProps>(function Image(\n  {\n    src: srcProp,\n    alt,\n    width,\n    height,\n    fill,\n    preload,\n    priority,\n    quality,\n    placeholder,\n    blurDataURL,\n    loader,\n    sizes,\n    className,\n    style,\n    onLoad,\n    onLoadingComplete,\n    onError,\n    unoptimized: _unoptimized,\n    overrideSrc: _overrideSrc,\n    loading,\n    ...rest\n  },\n  ref,\n) {\n  // Dedup refs: ensure onLoad and onError fire at most once per src per mount.\n  // Matches Next.js behavior — prevents double-firing from React re-renders,\n  // strict-mode double-invocation, or state updates inside the handler itself.\n  // Ported from Next.js: https://github.com/vercel/next.js/pull/93209\n  const lastLoadedSrcRef = useRef<string | undefined>(undefined);\n  const lastErrorSrcRef = useRef<string | undefined>(undefined);\n\n  // Hydration-level onError replay: when an image fails to load during SSR\n  // streaming or initial HTML parse (before React hydrates), the native browser\n  // error event is lost. Re-trigger it via `img.src = img.src` in a layout\n  // effect once hydration completes, mirroring the upstream Next.js fix.\n  // Ported from Next.js: https://github.com/vercel/next.js/pull/93209\n  const didInsertRef = useRef(false);\n  const imgElementRef = useRef<HTMLImageElement | null>(null);\n\n  // Merge forwarded ref with internal img ref for layout effect access.\n  const mergedRef = useMergedRef(ref, imgElementRef);\n\n  // Stable refs for onLoad / onError / onLoadingComplete so the layout effect\n  // does not re-run (and re-assign img.src) when handler identity changes.\n  // Ported from Next.js: https://github.com/vercel/next.js/pull/93209\n  //\n  // IMPORTANT: The useRef+useEffect sync pattern has a subtle timing gap:\n  // during the first render, onLoadRef.current holds the initial value from\n  // useRef(onLoad), and the useEffect to sync it runs AFTER the layout effect.\n  // This means on first mount the layout effect reads the correct initial\n  // value (passed to useRef). If someone changes useRef(onLoad) to\n  // useRef(undefined), the layout effect would read undefined on first mount.\n  const onLoadRef = useRef(onLoad);\n  useEffect(() => {\n    onLoadRef.current = onLoad;\n  }, [onLoad]);\n  const onErrorRef = useRef(onError);\n  useEffect(() => {\n    onErrorRef.current = onError;\n  }, [onError]);\n  const onLoadingCompleteRef = useRef(onLoadingComplete);\n  useEffect(() => {\n    onLoadingCompleteRef.current = onLoadingComplete;\n  }, [onLoadingComplete]);\n\n  const {\n    src,\n    width: imgWidth,\n    height: imgHeight,\n    blurDataURL: imgBlurDataURL,\n  } = resolveImageSource({ src: srcProp, width, height, blurDataURL });\n  const shouldPreload = preload === true || priority === true;\n  const priorityFetchPriority = priority ? \"high\" : undefined;\n  const imageLoading = priority ? \"eager\" : shouldPreload ? loading : (loading ?? \"lazy\");\n\n  const [completedBlurSrc, setCompletedBlurSrc] = useState<string | undefined>(undefined);\n  const blurComplete = completedBlurSrc === src;\n\n  const markBlurComplete = () => {\n    if (placeholder !== \"blur\") return;\n    setCompletedBlurSrc((current) => (current === src ? current : src));\n  };\n\n  useNonWarningLayoutEffect(() => {\n    if (!didInsertRef.current && imgElementRef.current !== null) {\n      const img = imgElementRef.current;\n      // Replay error events lost during SSR/hydration.\n      if (onErrorRef.current) {\n        // eslint-disable-next-line no-self-assign\n        img.src = img.src;\n      }\n      // Replay onLoad for images that completed loading before React hydrated\n      // (e.g. SSR streaming where the image arrives and renders before hydration\n      // finishes). Without this, onLoad never fires for those images.\n      //\n      // img.complete is true for both successfully-loaded and errored images\n      // (the HTML spec defines complete as true when the browser finished\n      // fetching, regardless of outcome). We must check naturalWidth > 0 to\n      // distinguish success from error — a failed image has naturalWidth === 0.\n      // Ported from Next.js: https://github.com/vercel/next.js/pull/93209\n      if (img.complete && img.naturalWidth > 0) {\n        markBlurComplete();\n        const currentOnLoad = onLoadRef.current;\n        const currentOnLoadingComplete = onLoadingCompleteRef.current;\n        if (currentOnLoad || currentOnLoadingComplete) {\n          // Dedup — fire at most once per src per mount, matching onLoad dedup\n          if (lastLoadedSrcRef.current !== src) {\n            lastLoadedSrcRef.current = src;\n            // Create a synthetic React event with the expected shape.\n            // next/image uses a similar pattern in `handleLoading`.\n            const syntheticEvent = createSyntheticLoadEvent(img);\n            currentOnLoad?.(syntheticEvent);\n            currentOnLoadingComplete?.(img);\n          }\n        }\n      }\n      didInsertRef.current = true;\n    }\n  }, [placeholder, sizes, _unoptimized]);\n\n  // Wire onLoadingComplete (deprecated) into onLoad — matches Next.js behavior.\n  // onLoad fires first, then onLoadingComplete receives the HTMLImageElement.\n  const handleLoad = onLoadingComplete\n    ? (e: React.SyntheticEvent<HTMLImageElement>) => {\n        if (lastLoadedSrcRef.current === src) return;\n        lastLoadedSrcRef.current = src;\n        markBlurComplete();\n        onLoad?.(e);\n        onLoadingComplete(e.currentTarget);\n      }\n    : onLoad\n      ? (e: React.SyntheticEvent<HTMLImageElement>) => {\n          if (lastLoadedSrcRef.current === src) return;\n          lastLoadedSrcRef.current = src;\n          markBlurComplete();\n          onLoad(e);\n        }\n      : placeholder === \"blur\"\n        ? () => {\n            if (lastLoadedSrcRef.current === src) return;\n            lastLoadedSrcRef.current = src;\n            markBlurComplete();\n          }\n        : undefined;\n\n  const handleError = onError\n    ? (e: React.SyntheticEvent<HTMLImageElement>) => {\n        if (lastErrorSrcRef.current === src) return;\n        lastErrorSrcRef.current = src;\n        markBlurComplete();\n        onError(e);\n      }\n    : placeholder === \"blur\"\n      ? () => {\n          if (lastErrorSrcRef.current === src) return;\n          lastErrorSrcRef.current = src;\n          markBlurComplete();\n        }\n      : undefined;\n\n  // If a custom loader is provided, use basic img with loader URL\n  if (loader) {\n    const resolvedSrc = loader({ src, width: imgWidth ?? 0, quality: quality ?? 75 });\n    preloadImageResource({\n      shouldPreload,\n      src: resolvedSrc,\n      sizes,\n      fetchPriority: priorityFetchPriority,\n    });\n    return (\n      <img\n        ref={mergedRef}\n        src={resolvedSrc}\n        alt={alt}\n        width={fill ? undefined : imgWidth}\n        height={fill ? undefined : imgHeight}\n        loading={imageLoading}\n        decoding=\"async\"\n        sizes={sizes}\n        className={className}\n        onLoad={handleLoad}\n        onError={handleError}\n        style={fill ? getFillStyle(style) : style}\n        {...rest}\n      />\n    );\n  }\n\n  // For remote URLs, validate against remotePatterns. Non-fill images use\n  // @unpic/react for CDN URL transforms; fill uses a plain img so the DOM\n  // element keeps Next.js's absolute-positioned fill contract.\n  if (isRemoteUrl(src)) {\n    const validation = validateRemoteUrl(src);\n    if (!validation.allowed) {\n      if (__isDev) {\n        console.warn(`[next/image] ${validation.reason}`);\n        // In dev, render the image but with a warning — matches Next.js dev behavior\n      } else {\n        // In production, block the image entirely\n        console.error(`[next/image] ${validation.reason}`);\n        return null;\n      }\n    }\n\n    const sanitizedBlur = imgBlurDataURL ? sanitizeBlurDataURL(imgBlurDataURL) : undefined;\n    const showBlur = !blurComplete && placeholder === \"blur\" && sanitizedBlur;\n    const blurStyle = showBlur\n      ? {\n          backgroundImage: `url(${sanitizedBlur})`,\n          backgroundSize: \"cover\",\n          backgroundRepeat: \"no-repeat\",\n          backgroundPosition: \"center\",\n        }\n      : undefined;\n    const bg = showBlur ? `url(${sanitizedBlur})` : undefined;\n\n    if (fill) {\n      const fillSizes = sizes ?? \"100vw\";\n      preloadImageResource({\n        shouldPreload,\n        src,\n        sizes: fillSizes,\n        fetchPriority: priorityFetchPriority,\n      });\n      return (\n        <img\n          ref={mergedRef}\n          src={src}\n          alt={alt}\n          // `priority` is a Next.js concept — translate it to HTML attributes so\n          // it is never forwarded to the DOM as a non-boolean attribute, which\n          // would trigger React's \"Received `true` for a non-boolean attribute\"\n          // warning.\n          loading={imageLoading}\n          fetchPriority={priorityFetchPriority}\n          decoding=\"async\"\n          sizes={fillSizes}\n          className={className}\n          data-nimg=\"fill\"\n          onLoad={handleLoad}\n          onError={handleError}\n          style={getFillStyle(style, blurStyle)}\n          {...rest}\n        />\n      );\n    }\n    // constrained layout requires width+height or aspectRatio\n    if (imgWidth && imgHeight) {\n      // @unpic/react forwards additional image props through transformProps and\n      // merges `style` with generated layout styles at runtime, but its public\n      // React type omits `style`.\n      const unpicRuntimeStyleProps: { style?: React.CSSProperties } = { style };\n      preloadImageResource({\n        shouldPreload,\n        src,\n        sizes,\n        fetchPriority: priorityFetchPriority,\n      });\n      return (\n        <UnpicImage\n          src={src}\n          alt={alt}\n          width={imgWidth}\n          height={imgHeight}\n          layout=\"constrained\"\n          // Same translation as above — never pass `priority` to the DOM.\n          loading={imageLoading}\n          fetchPriority={priorityFetchPriority}\n          sizes={sizes}\n          className={className}\n          {...unpicRuntimeStyleProps}\n          background={bg}\n          onLoad={handleLoad}\n          onError={handleError}\n          ref={mergedRef}\n        />\n      );\n    }\n    // Fall through to basic <img> if dimensions not provided\n    // (unpic requires them for constrained layout)\n  }\n\n  // Route local images through the /_next/image optimization endpoint.\n  // In production on Cloudflare Workers, this resizes and transcodes via\n  // the Images binding. In dev, it serves the original file as a passthrough.\n  // When `unoptimized` is true, bypass the endpoint entirely (Next.js compat).\n  // SVG sources auto-skip unless dangerouslyAllowSVG is enabled, matching\n  // Next.js behavior where .svg triggers unoptimized=true by default.\n  const imgQuality = quality ?? 75;\n  const isSvg = src.endsWith(\".svg\");\n  const skipOptimization = _unoptimized === true || (isSvg && !__dangerouslyAllowSVG);\n\n  // Build srcSet for responsive local images (common breakpoints).\n  // Each entry points to /_next/image with the appropriate width.\n  const srcSet =\n    imgWidth && !fill && !skipOptimization\n      ? generateSrcSet(src, imgWidth, imgQuality)\n      : imgWidth && !fill\n        ? RESPONSIVE_WIDTHS.filter((w) => w <= imgWidth * 2)\n            .map((w) => `${src} ${w}w`)\n            .join(\", \") || `${src} ${imgWidth}w`\n        : undefined;\n\n  // The main `src` also goes through the optimization endpoint. Use the\n  // declared width (or the first responsive width as fallback).\n  const optimizedSrc = skipOptimization\n    ? src\n    : imgWidth\n      ? imageOptimizationUrl(src, imgWidth, imgQuality)\n      : imageOptimizationUrl(src, RESPONSIVE_WIDTHS[0], imgQuality);\n\n  // Blur placeholder: show a low-quality background while the image loads.\n  // Sanitize blurDataURL to prevent CSS injection via crafted data URLs.\n  const sanitizedLocalBlur = imgBlurDataURL ? sanitizeBlurDataURL(imgBlurDataURL) : undefined;\n  const blurStyle =\n    !blurComplete && placeholder === \"blur\" && sanitizedLocalBlur\n      ? {\n          backgroundImage: `url(${sanitizedLocalBlur})`,\n          backgroundSize: \"cover\",\n          backgroundRepeat: \"no-repeat\",\n          backgroundPosition: \"center\",\n        }\n      : undefined;\n\n  const imageSizes = sizes ?? (fill ? \"100vw\" : undefined);\n  preloadImageResource({\n    shouldPreload,\n    src: optimizedSrc,\n    srcSet,\n    sizes: imageSizes,\n    fetchPriority: priorityFetchPriority,\n  });\n\n  // For local images, render a standard <img> tag with srcSet and blur support.\n  // The src and srcSet point to the /_next/image optimization endpoint.\n  return (\n    <img\n      ref={mergedRef}\n      src={optimizedSrc}\n      alt={alt}\n      width={fill ? undefined : imgWidth}\n      height={fill ? undefined : imgHeight}\n      loading={imageLoading}\n      fetchPriority={priorityFetchPriority}\n      decoding=\"async\"\n      srcSet={srcSet}\n      sizes={imageSizes}\n      className={className}\n      data-nimg={fill ? \"fill\" : \"1\"}\n      onLoad={handleLoad}\n      onError={handleError}\n      style={fill ? getFillStyle(style, blurStyle) : { ...blurStyle, ...style }}\n      {...rest}\n    />\n  );\n});\n\n/**\n * getImageProps — for advanced use cases (picture elements, background images).\n * Returns the props that would be passed to the underlying <img> element.\n */\nexport function getImageProps(props: ImageProps): {\n  props: React.ImgHTMLAttributes<HTMLImageElement>;\n} {\n  const {\n    src: srcProp,\n    alt,\n    width,\n    height,\n    fill,\n    preload: _preload,\n    priority,\n    quality: _quality,\n    placeholder,\n    blurDataURL: blurDataURLProp,\n    loader,\n    sizes,\n    className,\n    style,\n    onLoad: _onLoad,\n    onLoadingComplete: _onLoadingComplete,\n    unoptimized: _unoptimized,\n    overrideSrc: _overrideSrc,\n    loading,\n    ...rest\n  } = props;\n\n  const {\n    src,\n    width: imgWidth,\n    height: imgHeight,\n    blurDataURL: imgBlurDataURL,\n  } = resolveImageSource({ src: srcProp, width, height, blurDataURL: blurDataURLProp });\n  const shouldPreload = _preload === true || priority === true;\n\n  // Validate remote URLs against configured patterns\n  let blockedInProd = false;\n  if (isRemoteUrl(src)) {\n    const validation = validateRemoteUrl(src);\n    if (!validation.allowed) {\n      if (__isDev) {\n        console.warn(`[next/image] ${validation.reason}`);\n      } else {\n        console.error(`[next/image] ${validation.reason}`);\n        blockedInProd = true;\n      }\n    }\n  }\n\n  // Resolve src through custom loader if provided\n  const imgQuality = _quality ?? 75;\n  const resolvedSrc = blockedInProd\n    ? \"\"\n    : loader\n      ? loader({ src, width: imgWidth ?? 0, quality: imgQuality })\n      : src;\n\n  // For local images (no loader, not remote), route through optimization endpoint.\n  // When `unoptimized` is true, bypass the endpoint entirely (Next.js compat).\n  // SVG sources auto-skip unless dangerouslyAllowSVG is enabled.\n  const isSvg = resolvedSrc.endsWith(\".svg\");\n  const skipOpt =\n    _unoptimized === true ||\n    (isSvg && !__dangerouslyAllowSVG) ||\n    blockedInProd ||\n    !!loader ||\n    isRemoteUrl(resolvedSrc);\n  const optimizedSrc = skipOpt\n    ? resolvedSrc\n    : imgWidth\n      ? imageOptimizationUrl(resolvedSrc, imgWidth, imgQuality)\n      : imageOptimizationUrl(resolvedSrc, RESPONSIVE_WIDTHS[0], imgQuality);\n\n  // Build srcSet for local images — each width points to /_next/image\n  const srcSet =\n    imgWidth && !fill && !isRemoteUrl(resolvedSrc) && !loader && !skipOpt\n      ? generateSrcSet(resolvedSrc, imgWidth, imgQuality)\n      : undefined;\n\n  // Blur placeholder styles — sanitize to prevent CSS injection\n  const sanitizedBlurURL = imgBlurDataURL ? sanitizeBlurDataURL(imgBlurDataURL) : undefined;\n  const blurStyle =\n    placeholder === \"blur\" && sanitizedBlurURL\n      ? {\n          backgroundImage: `url(${sanitizedBlurURL})`,\n          backgroundSize: \"cover\",\n          backgroundRepeat: \"no-repeat\" as const,\n          backgroundPosition: \"center\" as const,\n        }\n      : undefined;\n\n  return {\n    props: {\n      src: optimizedSrc,\n      alt,\n      width: fill ? undefined : imgWidth,\n      height: fill ? undefined : imgHeight,\n      loading: priority ? \"eager\" : shouldPreload ? loading : (loading ?? \"lazy\"),\n      fetchPriority: priority ? (\"high\" as const) : undefined,\n      decoding: \"async\" as const,\n      srcSet,\n      sizes: sizes ?? (fill ? \"100vw\" : undefined),\n      className,\n      \"data-nimg\": fill ? \"fill\" : \"1\",\n      style: fill ? getFillStyle(style, blurStyle) : { ...blurStyle, ...style },\n      ...rest,\n    } as React.ImgHTMLAttributes<HTMLImageElement>,\n  };\n}\n\nexport default Image;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAM,+BAAgD;CACpD,IAAI;EACF,OAAO,KAAK,MAAM,QAAQ,IAAI,kCAAkC,KAAK;SAC/D;EACN,OAAO,EAAE;;IAET;AACJ,MAAM,wBAAkC;CACtC,IAAI;EACF,OAAO,KAAK,MAAM,QAAQ,IAAI,0BAA0B,KAAK;SACvD;EACN,OAAO,EAAE;;IAET;AACJ,MAAM,mBAAmB,sBAAsB,SAAS,KAAK,eAAe,SAAS;AACrF,MAAM,UAAU,QAAQ,IAAI,aAAa;AACzC,MAAM,4BAAsC;CAC1C,IAAI;EACF,OAAO,KAAK,MACV,QAAQ,IAAI,+BAA+B,yCAC5C;SACK;EACN,OAAO;GAAC;GAAK;GAAK;GAAK;GAAM;GAAM;GAAM;GAAM;GAAK;;IAEpD;;;;;;;;AAQJ,MAAM,wBAAwB,QAAQ,IAAI,yCAAyC;;;;;;AAMnF,MAAM,4BAA4B,QAAQ,IAAI,8CAA8C;;;;;;;;;;;;;;;AAgB5F,SAAS,kBAAkB,KAAoD;CAC7E,IAAI;CACJ,IAAI;EACF,MAAM,IAAI,IAAI,KAAK,WAAW;SACxB;EACN,OAAO;GAAE,SAAS;GAAO,QAAQ,gBAAgB;GAAO;;CAG1D,IAAI,CAAC,6BAA6B,YAAY,IAAI,SAAS,EAIzD,OAAO;EACL,SAAS;EACT,QAAQ,cAAc,IAAI;EAC3B;CAGH,IAAI,CAAC,kBAEH,OAAO,EAAE,SAAS,MAAM;CAG1B,IAAI,eAAe,gBAAgB,uBAAuB,IAAI,EAC5D,OAAO,EAAE,SAAS,MAAM;CAG1B,OAAO;EACL,SAAS;EACT,QAAQ,cAAc,IAAI;EAC3B;;;;;;;;AASH,MAAM,4BAA4B,OAAO,WAAW,cAAc,YAAY;;;;;;;;;AAU9E,SAAS,yBAAyB,KAA+D;CAC/F,MAAM,cAAc,IAAI,MAAM,OAAO;CACrC,OAAO,eAAe,aAAa,UAAU;EAAE,UAAU;EAAO,OAAO;EAAK,CAAC;CAC7E,IAAI,YAAY;CAChB,IAAI,UAAU;CACd,OAAO;EACL,SAAS,YAAY;EACrB,YAAY,YAAY;EACxB,eAAe;EACf,kBAAkB;EAClB,YAAY,YAAY;EACxB,WAAW;EACX;EACA,QAAQ;EACR,WAAW,YAAY;EACvB,MAAM;EACN,0BAA0B;EAC1B,4BAA4B;EAC5B,eAAe;EACf,sBAAsB;GACpB,YAAY;GACZ,YAAY,gBAAgB;;EAE9B,uBAAuB;GACrB,UAAU;GACV,YAAY,iBAAiB;;EAEhC;;;;;;;;;;;;;;;;AA4CH,SAAS,oBAAoB,KAAiC;CAE5D,IAAI,CAAC,IAAI,WAAW,cAAc,EAAE,OAAO,KAAA;CAO3C,IAAI,iBAAiB,KAAK,IAAI,EAAE,OAAO,KAAA;CACvC,OAAO;;;;;AAMT,SAAS,YAAY,KAAsB;CACzC,OAAO,IAAI,WAAW,UAAU,IAAI,IAAI,WAAW,WAAW,IAAI,IAAI,WAAW,KAAK;;AAGxF,SAAS,aACP,OACA,iBACqB;CACrB,OAAO;EACL,UAAU;EACV,OAAO;EACP,OAAO;EACP,QAAQ;EACR,WAAW;EACX,GAAG;EACH,GAAG;EACJ;;;;;;AAOH,SAAS,mBAAmB,GAK+C;CAMzE,OAAO;EAAE,KALG,OAAO,EAAE,QAAQ,WAAW,EAAE,MAAM,EAAE,IAAI;EAKxC,OAJG,EAAE,UAAU,OAAO,EAAE,QAAQ,WAAW,EAAE,IAAI,QAAQ,KAAA;EAIxC,QAHb,EAAE,WAAW,OAAO,EAAE,QAAQ,WAAW,EAAE,IAAI,SAAS,KAAA;EAGxB,aADhD,EAAE,gBAAgB,OAAO,EAAE,QAAQ,WAAW,EAAE,IAAI,cAAc,KAAA;EACW;;;;;;;AAQjF,MAAM,oBAAoB;;;;;;;;AAS1B,SAAgB,qBAAqB,KAAa,OAAe,UAAkB,IAAY;CAC7F,OAAO,oBAAoB,mBAAmB,IAAI,CAAC,KAAK,MAAM,KAAK;;AAGrE,SAAS,qBAAqB,OAMrB;CACP,IAAI,CAAC,MAAM,eAAe;CAC1B,IAAI,OAAO,SAAS,YAAY,YAAY;CAC5C,SAAS,QAAQ,MAAM,KAAK;EAC1B,IAAI;EACJ,aAAa,MAAM;EACnB,YAAY,MAAM;EAClB,eAAe,MAAM;EACtB,CAAC;;;;;;;;;AAUJ,SAAS,eAAe,KAAa,eAAuB,UAAkB,IAAY;CACxF,MAAM,SAAS,kBAAkB,QAAQ,MAAM,KAAK,gBAAgB,EAAE;CACtE,IAAI,OAAO,WAAW,GACpB,OAAO,GAAG,qBAAqB,KAAK,eAAe,QAAQ,CAAC,GAAG,cAAc;CAC/E,OAAO,OAAO,KAAK,MAAM,GAAG,qBAAqB,KAAK,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,KAAK;;AAGvF,MAAM,QAAQ,WAAyC,SAAS,MAC9D,EACE,KAAK,SACL,KACA,OACA,QACA,MACA,SACA,UACA,SACA,aACA,aACA,QACA,OACA,WACA,OACA,QACA,mBACA,SACA,aAAa,cACb,aAAa,cACb,SACA,GAAG,QAEL,KACA;CAKA,MAAM,mBAAmB,OAA2B,KAAA,EAAU;CAC9D,MAAM,kBAAkB,OAA2B,KAAA,EAAU;CAO7D,MAAM,eAAe,OAAO,MAAM;CAClC,MAAM,gBAAgB,OAAgC,KAAK;CAG3D,MAAM,YAAY,aAAa,KAAK,cAAc;CAYlD,MAAM,YAAY,OAAO,OAAO;CAChC,gBAAgB;EACd,UAAU,UAAU;IACnB,CAAC,OAAO,CAAC;CACZ,MAAM,aAAa,OAAO,QAAQ;CAClC,gBAAgB;EACd,WAAW,UAAU;IACpB,CAAC,QAAQ,CAAC;CACb,MAAM,uBAAuB,OAAO,kBAAkB;CACtD,gBAAgB;EACd,qBAAqB,UAAU;IAC9B,CAAC,kBAAkB,CAAC;CAEvB,MAAM,EACJ,KACA,OAAO,UACP,QAAQ,WACR,aAAa,mBACX,mBAAmB;EAAE,KAAK;EAAS;EAAO;EAAQ;EAAa,CAAC;CACpE,MAAM,gBAAgB,YAAY,QAAQ,aAAa;CACvD,MAAM,wBAAwB,WAAW,SAAS,KAAA;CAClD,MAAM,eAAe,WAAW,UAAU,gBAAgB,UAAW,WAAW;CAEhF,MAAM,CAAC,kBAAkB,uBAAuB,SAA6B,KAAA,EAAU;CACvF,MAAM,eAAe,qBAAqB;CAE1C,MAAM,yBAAyB;EAC7B,IAAI,gBAAgB,QAAQ;EAC5B,qBAAqB,YAAa,YAAY,MAAM,UAAU,IAAK;;CAGrE,gCAAgC;EAC9B,IAAI,CAAC,aAAa,WAAW,cAAc,YAAY,MAAM;GAC3D,MAAM,MAAM,cAAc;GAE1B,IAAI,WAAW,SAEb,IAAI,MAAM,IAAI;GAWhB,IAAI,IAAI,YAAY,IAAI,eAAe,GAAG;IACxC,kBAAkB;IAClB,MAAM,gBAAgB,UAAU;IAChC,MAAM,2BAA2B,qBAAqB;IACtD,IAAI,iBAAiB;SAEf,iBAAiB,YAAY,KAAK;MACpC,iBAAiB,UAAU;MAG3B,MAAM,iBAAiB,yBAAyB,IAAI;MACpD,gBAAgB,eAAe;MAC/B,2BAA2B,IAAI;;;;GAIrC,aAAa,UAAU;;IAExB;EAAC;EAAa;EAAO;EAAa,CAAC;CAItC,MAAM,aAAa,qBACd,MAA8C;EAC7C,IAAI,iBAAiB,YAAY,KAAK;EACtC,iBAAiB,UAAU;EAC3B,kBAAkB;EAClB,SAAS,EAAE;EACX,kBAAkB,EAAE,cAAc;KAEpC,UACG,MAA8C;EAC7C,IAAI,iBAAiB,YAAY,KAAK;EACtC,iBAAiB,UAAU;EAC3B,kBAAkB;EAClB,OAAO,EAAE;KAEX,gBAAgB,eACR;EACJ,IAAI,iBAAiB,YAAY,KAAK;EACtC,iBAAiB,UAAU;EAC3B,kBAAkB;KAEpB,KAAA;CAER,MAAM,cAAc,WACf,MAA8C;EAC7C,IAAI,gBAAgB,YAAY,KAAK;EACrC,gBAAgB,UAAU;EAC1B,kBAAkB;EAClB,QAAQ,EAAE;KAEZ,gBAAgB,eACR;EACJ,IAAI,gBAAgB,YAAY,KAAK;EACrC,gBAAgB,UAAU;EAC1B,kBAAkB;KAEpB,KAAA;CAGN,IAAI,QAAQ;EACV,MAAM,cAAc,OAAO;GAAE;GAAK,OAAO,YAAY;GAAG,SAAS,WAAW;GAAI,CAAC;EACjF,qBAAqB;GACnB;GACA,KAAK;GACL;GACA,eAAe;GAChB,CAAC;EACF,OACE,oBAAC,OAAD;GACE,KAAK;GACL,KAAK;GACA;GACL,OAAO,OAAO,KAAA,IAAY;GAC1B,QAAQ,OAAO,KAAA,IAAY;GAC3B,SAAS;GACT,UAAS;GACF;GACI;GACX,QAAQ;GACR,SAAS;GACT,OAAO,OAAO,aAAa,MAAM,GAAG;GACpC,GAAI;GACJ,CAAA;;CAON,IAAI,YAAY,IAAI,EAAE;EACpB,MAAM,aAAa,kBAAkB,IAAI;EACzC,IAAI,CAAC,WAAW,SACd,IAAI,SACF,QAAQ,KAAK,gBAAgB,WAAW,SAAS;OAE5C;GAEL,QAAQ,MAAM,gBAAgB,WAAW,SAAS;GAClD,OAAO;;EAIX,MAAM,gBAAgB,iBAAiB,oBAAoB,eAAe,GAAG,KAAA;EAC7E,MAAM,WAAW,CAAC,gBAAgB,gBAAgB,UAAU;EAC5D,MAAM,YAAY,WACd;GACE,iBAAiB,OAAO,cAAc;GACtC,gBAAgB;GAChB,kBAAkB;GAClB,oBAAoB;GACrB,GACD,KAAA;EACJ,MAAM,KAAK,WAAW,OAAO,cAAc,KAAK,KAAA;EAEhD,IAAI,MAAM;GACR,MAAM,YAAY,SAAS;GAC3B,qBAAqB;IACnB;IACA;IACA,OAAO;IACP,eAAe;IAChB,CAAC;GACF,OACE,oBAAC,OAAD;IACE,KAAK;IACA;IACA;IAKL,SAAS;IACT,eAAe;IACf,UAAS;IACT,OAAO;IACI;IACX,aAAU;IACV,QAAQ;IACR,SAAS;IACT,OAAO,aAAa,OAAO,UAAU;IACrC,GAAI;IACJ,CAAA;;EAIN,IAAI,YAAY,WAAW;GAIzB,MAAM,yBAA0D,EAAE,OAAO;GACzE,qBAAqB;IACnB;IACA;IACA;IACA,eAAe;IAChB,CAAC;GACF,OACE,oBAACA,SAAD;IACO;IACA;IACL,OAAO;IACP,QAAQ;IACR,QAAO;IAEP,SAAS;IACT,eAAe;IACR;IACI;IACX,GAAI;IACJ,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,KAAK;IACL,CAAA;;;CAaR,MAAM,aAAa,WAAW;CAC9B,MAAM,QAAQ,IAAI,SAAS,OAAO;CAClC,MAAM,mBAAmB,iBAAiB,QAAS,SAAS,CAAC;CAI7D,MAAM,SACJ,YAAY,CAAC,QAAQ,CAAC,mBAClB,eAAe,KAAK,UAAU,WAAW,GACzC,YAAY,CAAC,OACX,kBAAkB,QAAQ,MAAM,KAAK,WAAW,EAAE,CAC/C,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,GAAG,CAC1B,KAAK,KAAK,IAAI,GAAG,IAAI,GAAG,SAAS,KACpC,KAAA;CAIR,MAAM,eAAe,mBACjB,MACA,WACE,qBAAqB,KAAK,UAAU,WAAW,GAC/C,qBAAqB,KAAK,kBAAkB,IAAI,WAAW;CAIjE,MAAM,qBAAqB,iBAAiB,oBAAoB,eAAe,GAAG,KAAA;CAClF,MAAM,YACJ,CAAC,gBAAgB,gBAAgB,UAAU,qBACvC;EACE,iBAAiB,OAAO,mBAAmB;EAC3C,gBAAgB;EAChB,kBAAkB;EAClB,oBAAoB;EACrB,GACD,KAAA;CAEN,MAAM,aAAa,UAAU,OAAO,UAAU,KAAA;CAC9C,qBAAqB;EACnB;EACA,KAAK;EACL;EACA,OAAO;EACP,eAAe;EAChB,CAAC;CAIF,OACE,oBAAC,OAAD;EACE,KAAK;EACL,KAAK;EACA;EACL,OAAO,OAAO,KAAA,IAAY;EAC1B,QAAQ,OAAO,KAAA,IAAY;EAC3B,SAAS;EACT,eAAe;EACf,UAAS;EACD;EACR,OAAO;EACI;EACX,aAAW,OAAO,SAAS;EAC3B,QAAQ;EACR,SAAS;EACT,OAAO,OAAO,aAAa,OAAO,UAAU,GAAG;GAAE,GAAG;GAAW,GAAG;GAAO;EACzE,GAAI;EACJ,CAAA;EAEJ;;;;;AAMF,SAAgB,cAAc,OAE5B;CACA,MAAM,EACJ,KAAK,SACL,KACA,OACA,QACA,MACA,SAAS,UACT,UACA,SAAS,UACT,aACA,aAAa,iBACb,QACA,OACA,WACA,OACA,QAAQ,SACR,mBAAmB,oBACnB,aAAa,cACb,aAAa,cACb,SACA,GAAG,SACD;CAEJ,MAAM,EACJ,KACA,OAAO,UACP,QAAQ,WACR,aAAa,mBACX,mBAAmB;EAAE,KAAK;EAAS;EAAO;EAAQ,aAAa;EAAiB,CAAC;CACrF,MAAM,gBAAgB,aAAa,QAAQ,aAAa;CAGxD,IAAI,gBAAgB;CACpB,IAAI,YAAY,IAAI,EAAE;EACpB,MAAM,aAAa,kBAAkB,IAAI;EACzC,IAAI,CAAC,WAAW,SACd,IAAI,SACF,QAAQ,KAAK,gBAAgB,WAAW,SAAS;OAC5C;GACL,QAAQ,MAAM,gBAAgB,WAAW,SAAS;GAClD,gBAAgB;;;CAMtB,MAAM,aAAa,YAAY;CAC/B,MAAM,cAAc,gBAChB,KACA,SACE,OAAO;EAAE;EAAK,OAAO,YAAY;EAAG,SAAS;EAAY,CAAC,GAC1D;CAKN,MAAM,QAAQ,YAAY,SAAS,OAAO;CAC1C,MAAM,UACJ,iBAAiB,QAChB,SAAS,CAAC,yBACX,iBACA,CAAC,CAAC,UACF,YAAY,YAAY;CAC1B,MAAM,eAAe,UACjB,cACA,WACE,qBAAqB,aAAa,UAAU,WAAW,GACvD,qBAAqB,aAAa,kBAAkB,IAAI,WAAW;CAGzE,MAAM,SACJ,YAAY,CAAC,QAAQ,CAAC,YAAY,YAAY,IAAI,CAAC,UAAU,CAAC,UAC1D,eAAe,aAAa,UAAU,WAAW,GACjD,KAAA;CAGN,MAAM,mBAAmB,iBAAiB,oBAAoB,eAAe,GAAG,KAAA;CAChF,MAAM,YACJ,gBAAgB,UAAU,mBACtB;EACE,iBAAiB,OAAO,iBAAiB;EACzC,gBAAgB;EAChB,kBAAkB;EAClB,oBAAoB;EACrB,GACD,KAAA;CAEN,OAAO,EACL,OAAO;EACL,KAAK;EACL;EACA,OAAO,OAAO,KAAA,IAAY;EAC1B,QAAQ,OAAO,KAAA,IAAY;EAC3B,SAAS,WAAW,UAAU,gBAAgB,UAAW,WAAW;EACpE,eAAe,WAAY,SAAmB,KAAA;EAC9C,UAAU;EACV;EACA,OAAO,UAAU,OAAO,UAAU,KAAA;EAClC;EACA,aAAa,OAAO,SAAS;EAC7B,OAAO,OAAO,aAAa,OAAO,UAAU,GAAG;GAAE,GAAG;GAAW,GAAG;GAAO;EACzE,GAAG;EACJ,EACF"}

package/dist/shims/internal/pages-data-target.d.ts

@@ -0,0 +1,58 @@
+//#region src/shims/internal/pages-data-target.d.ts
+type PagesDataTarget = {
+  /** Final fetch URL for the data endpoint, including basePath and search. */dataHref: string; /** Matched route pattern (e.g. `/blog/[slug]`). */
+  pattern: string; /** Dynamic params extracted from the URL by the pattern matcher. */
+  params: Record<string, string | string[]>; /** Code-split loader thunk for the matched route's page module. */
+  loader: () => Promise<{
+    default?: unknown;
+    [key: string]: unknown;
+  }>; /** Current buildId snapshot, used by the data URL and consistency checks. */
+  buildId: string; /** Locale-prefixed (server-routable) page path. */
+  pagePath: string; /** URL search string including the leading `?`. */
+  search: string;
+  /**
+   * Locale prefix detected on the URL, or `undefined` when the URL is
+   * unprefixed (default locale, or no i18n configured). Lets the caller refresh
+   * locale state on locale transitions, which the data JSON envelope itself
+   * does not carry.
+   */
+  locale: string | undefined;
+};
+/**
+ * Decide whether the JSON data-endpoint navigation path is usable for this
+ * browser URL. We require:
+ *   - A registered code-split loader for the matched route pattern. Without
+ *     this, the client has no chunk URL to import for the new page.
+ *   - A buildId on the current `__NEXT_DATA__`, since the data URL embeds it.
+ *   - Same-origin (cross-origin URLs do not hit our data endpoint).
+ *
+ * Locale handling: route patterns in `__VINEXT_PAGE_PATTERNS__` are
+ * locale-unaware (`/about`, not `/fr/about`), but the browser URL for a
+ * locale-prefixed page is `/fr/about`. We strip the locale prefix before
+ * pattern matching so locale transitions hit the JSON fast path. The data URL
+ * itself keeps the locale prefix because the server uses it to pick
+ * locale-specific gSSP data.
+ *
+ * Returns the resolved target, or `null` to signal the caller should fall
+ * back to the HTML extraction path (dev server, or a route that exists on the
+ * server but is not in the client loader map).
+ *
+ * Ported from Next.js: `packages/next/src/client/page-loader.ts`
+ * (`getDataHref`). vinext's equivalent uses an in-memory loader map instead
+ * of Next.js' `_buildManifest.js`.
+ */
+declare function resolvePagesDataNavigationTarget(browserUrl: string, basePath: string): PagesDataTarget | null;
+/**
+ * Inject a `<link rel="prefetch">` for the data JSON and kick off the
+ * code-split loader so the chunk is warm by the time the user clicks.
+ *
+ * Used by both `Router.prefetch()` and `<Link>` hover/viewport prefetch. The
+ * loader's returned Promise is intentionally discarded — `import()` caches the
+ * result, so a subsequent navigation re-invocation hits the cache without
+ * paying for a second round trip. Errors are swallowed: prefetch is
+ * best-effort and must never break the page.
+ */
+declare function prefetchPagesData(target: PagesDataTarget): void;
+//#endregion
+export { PagesDataTarget, prefetchPagesData, resolvePagesDataNavigationTarget };
+//# sourceMappingURL=pages-data-target.d.ts.map

package/dist/shims/internal/pages-data-target.js

@@ -0,0 +1,91 @@
+import { stripBasePath } from "../../utils/base-path.js";
+import { getLocalePathPrefix } from "../../utils/domain-locale.js";
+import { buildPagesDataHref, matchPagesPattern } from "./pages-data-url.js";
+//#region src/shims/internal/pages-data-target.ts
+/**
+* Shared decision helper for the Pages Router `/_next/data/<id>/<page>.json`
+* navigation fast path. Used by both the router shim (for `navigateClient` and
+* `Router.prefetch`) and the Link shim (for hover/viewport prefetch).
+*
+* Lives in `shims/internal/` so neither caller pulls in the router shim at
+* module init time — link.tsx and router.ts must remain free of circular
+* imports and SSR-side router-init side effects.
+*/
+/**
+* Decide whether the JSON data-endpoint navigation path is usable for this
+* browser URL. We require:
+*   - A registered code-split loader for the matched route pattern. Without
+*     this, the client has no chunk URL to import for the new page.
+*   - A buildId on the current `__NEXT_DATA__`, since the data URL embeds it.
+*   - Same-origin (cross-origin URLs do not hit our data endpoint).
+*
+* Locale handling: route patterns in `__VINEXT_PAGE_PATTERNS__` are
+* locale-unaware (`/about`, not `/fr/about`), but the browser URL for a
+* locale-prefixed page is `/fr/about`. We strip the locale prefix before
+* pattern matching so locale transitions hit the JSON fast path. The data URL
+* itself keeps the locale prefix because the server uses it to pick
+* locale-specific gSSP data.
+*
+* Returns the resolved target, or `null` to signal the caller should fall
+* back to the HTML extraction path (dev server, or a route that exists on the
+* server but is not in the client loader map).
+*
+* Ported from Next.js: `packages/next/src/client/page-loader.ts`
+* (`getDataHref`). vinext's equivalent uses an in-memory loader map instead
+* of Next.js' `_buildManifest.js`.
+*/
+function resolvePagesDataNavigationTarget(browserUrl, basePath) {
+	if (typeof window === "undefined") return null;
+	const loaders = window.__VINEXT_PAGE_LOADERS__;
+	const patterns = window.__VINEXT_PAGE_PATTERNS__;
+	if (!loaders || !patterns || patterns.length === 0) return null;
+	const buildId = window.__NEXT_DATA__?.buildId ?? void 0;
+	if (!buildId) return null;
+	let parsed;
+	try {
+		parsed = new URL(browserUrl, window.location.href);
+	} catch {
+		return null;
+	}
+	if (parsed.origin !== window.location.origin) return null;
+	const pagePath = stripBasePath(parsed.pathname, basePath);
+	const locale = getLocalePathPrefix(pagePath, window.__VINEXT_LOCALES__);
+	const match = matchPagesPattern(locale ? pagePath.slice(locale.length + 1) || "/" : pagePath, patterns);
+	if (!match) return null;
+	const loader = loaders[match.pattern];
+	if (!loader) return null;
+	return {
+		dataHref: buildPagesDataHref(basePath, buildId, pagePath, parsed.search),
+		pattern: match.pattern,
+		params: match.params,
+		loader,
+		buildId,
+		pagePath,
+		search: parsed.search,
+		locale
+	};
+}
+/**
+* Inject a `<link rel="prefetch">` for the data JSON and kick off the
+* code-split loader so the chunk is warm by the time the user clicks.
+*
+* Used by both `Router.prefetch()` and `<Link>` hover/viewport prefetch. The
+* loader's returned Promise is intentionally discarded — `import()` caches the
+* result, so a subsequent navigation re-invocation hits the cache without
+* paying for a second round trip. Errors are swallowed: prefetch is
+* best-effort and must never break the page.
+*/
+function prefetchPagesData(target) {
+	if (typeof document === "undefined") return;
+	const link = document.createElement("link");
+	link.rel = "prefetch";
+	link.as = "fetch";
+	link.crossOrigin = "anonymous";
+	link.href = target.dataHref;
+	document.head.appendChild(link);
+	target.loader().catch(() => {});
+}
+//#endregion
+export { prefetchPagesData, resolvePagesDataNavigationTarget };
+
+//# sourceMappingURL=pages-data-target.js.map

package/dist/shims/internal/pages-data-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages-data-target.js","names":[],"sources":["../../../src/shims/internal/pages-data-target.ts"],"sourcesContent":["/**\n * Shared decision helper for the Pages Router `/_next/data/<id>/<page>.json`\n * navigation fast path. Used by both the router shim (for `navigateClient` and\n * `Router.prefetch`) and the Link shim (for hover/viewport prefetch).\n *\n * Lives in `shims/internal/` so neither caller pulls in the router shim at\n * module init time — link.tsx and router.ts must remain free of circular\n * imports and SSR-side router-init side effects.\n */\nimport { stripBasePath } from \"../../utils/base-path.js\";\nimport { getLocalePathPrefix } from \"../../utils/domain-locale.js\";\nimport type { VinextNextData } from \"../../client/vinext-next-data.js\";\nimport { buildPagesDataHref, matchPagesPattern } from \"./pages-data-url.js\";\n\nexport type PagesDataTarget = {\n  /** Final fetch URL for the data endpoint, including basePath and search. */\n  dataHref: string;\n  /** Matched route pattern (e.g. `/blog/[slug]`). */\n  pattern: string;\n  /** Dynamic params extracted from the URL by the pattern matcher. */\n  params: Record<string, string | string[]>;\n  /** Code-split loader thunk for the matched route's page module. */\n  loader: () => Promise<{ default?: unknown; [key: string]: unknown }>;\n  /** Current buildId snapshot, used by the data URL and consistency checks. */\n  buildId: string;\n  /** Locale-prefixed (server-routable) page path. */\n  pagePath: string;\n  /** URL search string including the leading `?`. */\n  search: string;\n  /**\n   * Locale prefix detected on the URL, or `undefined` when the URL is\n   * unprefixed (default locale, or no i18n configured). Lets the caller refresh\n   * locale state on locale transitions, which the data JSON envelope itself\n   * does not carry.\n   */\n  locale: string | undefined;\n};\n\n/**\n * Decide whether the JSON data-endpoint navigation path is usable for this\n * browser URL. We require:\n *   - A registered code-split loader for the matched route pattern. Without\n *     this, the client has no chunk URL to import for the new page.\n *   - A buildId on the current `__NEXT_DATA__`, since the data URL embeds it.\n *   - Same-origin (cross-origin URLs do not hit our data endpoint).\n *\n * Locale handling: route patterns in `__VINEXT_PAGE_PATTERNS__` are\n * locale-unaware (`/about`, not `/fr/about`), but the browser URL for a\n * locale-prefixed page is `/fr/about`. We strip the locale prefix before\n * pattern matching so locale transitions hit the JSON fast path. The data URL\n * itself keeps the locale prefix because the server uses it to pick\n * locale-specific gSSP data.\n *\n * Returns the resolved target, or `null` to signal the caller should fall\n * back to the HTML extraction path (dev server, or a route that exists on the\n * server but is not in the client loader map).\n *\n * Ported from Next.js: `packages/next/src/client/page-loader.ts`\n * (`getDataHref`). vinext's equivalent uses an in-memory loader map instead\n * of Next.js' `_buildManifest.js`.\n */\nexport function resolvePagesDataNavigationTarget(\n  browserUrl: string,\n  basePath: string,\n): PagesDataTarget | null {\n  if (typeof window === \"undefined\") return null;\n\n  const loaders = window.__VINEXT_PAGE_LOADERS__;\n  const patterns = window.__VINEXT_PAGE_PATTERNS__;\n  if (!loaders || !patterns || patterns.length === 0) return null;\n\n  const buildId = (window.__NEXT_DATA__ as VinextNextData | undefined)?.buildId ?? undefined;\n  if (!buildId) return null;\n\n  let parsed: URL;\n  try {\n    parsed = new URL(browserUrl, window.location.href);\n  } catch {\n    return null;\n  }\n  if (parsed.origin !== window.location.origin) return null;\n\n  const pagePath = stripBasePath(parsed.pathname, basePath);\n  const locale = getLocalePathPrefix(pagePath, window.__VINEXT_LOCALES__);\n  // `locale.length + 1` skips the `/<locale>` segment. If only the locale was\n  // present (`/fr`) the remainder is empty, which normalises to `/` (root).\n  const pathForMatch = locale ? pagePath.slice(locale.length + 1) || \"/\" : pagePath;\n\n  const match = matchPagesPattern(pathForMatch, patterns);\n  if (!match) return null;\n\n  const loader = loaders[match.pattern];\n  if (!loader) return null;\n\n  return {\n    dataHref: buildPagesDataHref(basePath, buildId, pagePath, parsed.search),\n    pattern: match.pattern,\n    params: match.params,\n    loader,\n    buildId,\n    pagePath,\n    search: parsed.search,\n    locale,\n  };\n}\n\n/**\n * Inject a `<link rel=\"prefetch\">` for the data JSON and kick off the\n * code-split loader so the chunk is warm by the time the user clicks.\n *\n * Used by both `Router.prefetch()` and `<Link>` hover/viewport prefetch. The\n * loader's returned Promise is intentionally discarded — `import()` caches the\n * result, so a subsequent navigation re-invocation hits the cache without\n * paying for a second round trip. Errors are swallowed: prefetch is\n * best-effort and must never break the page.\n */\nexport function prefetchPagesData(target: PagesDataTarget): void {\n  if (typeof document === \"undefined\") return;\n\n  const link = document.createElement(\"link\");\n  link.rel = \"prefetch\";\n  link.as = \"fetch\";\n  link.crossOrigin = \"anonymous\";\n  link.href = target.dataHref;\n  document.head.appendChild(link);\n\n  void target.loader().catch(() => {});\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,SAAgB,iCACd,YACA,UACwB;CACxB,IAAI,OAAO,WAAW,aAAa,OAAO;CAE1C,MAAM,UAAU,OAAO;CACvB,MAAM,WAAW,OAAO;CACxB,IAAI,CAAC,WAAW,CAAC,YAAY,SAAS,WAAW,GAAG,OAAO;CAE3D,MAAM,UAAW,OAAO,eAA8C,WAAW,KAAA;CACjF,IAAI,CAAC,SAAS,OAAO;CAErB,IAAI;CACJ,IAAI;EACF,SAAS,IAAI,IAAI,YAAY,OAAO,SAAS,KAAK;SAC5C;EACN,OAAO;;CAET,IAAI,OAAO,WAAW,OAAO,SAAS,QAAQ,OAAO;CAErD,MAAM,WAAW,cAAc,OAAO,UAAU,SAAS;CACzD,MAAM,SAAS,oBAAoB,UAAU,OAAO,mBAAmB;CAKvE,MAAM,QAAQ,kBAFO,SAAS,SAAS,MAAM,OAAO,SAAS,EAAE,IAAI,MAAM,UAE3B,SAAS;CACvD,IAAI,CAAC,OAAO,OAAO;CAEnB,MAAM,SAAS,QAAQ,MAAM;CAC7B,IAAI,CAAC,QAAQ,OAAO;CAEpB,OAAO;EACL,UAAU,mBAAmB,UAAU,SAAS,UAAU,OAAO,OAAO;EACxE,SAAS,MAAM;EACf,QAAQ,MAAM;EACd;EACA;EACA;EACA,QAAQ,OAAO;EACf;EACD;;;;;;;;;;;;AAaH,SAAgB,kBAAkB,QAA+B;CAC/D,IAAI,OAAO,aAAa,aAAa;CAErC,MAAM,OAAO,SAAS,cAAc,OAAO;CAC3C,KAAK,MAAM;CACX,KAAK,KAAK;CACV,KAAK,cAAc;CACnB,KAAK,OAAO,OAAO;CACnB,SAAS,KAAK,YAAY,KAAK;CAE/B,OAAY,QAAQ,CAAC,YAAY,GAAG"}

package/dist/shims/internal/pages-data-url.d.ts

@@ -0,0 +1,42 @@
+//#region src/shims/internal/pages-data-url.d.ts
+/**
+ * Append `.json` and the `/_next/data/<buildId>` prefix to a page pathname.
+ *
+ * Mirrors Next.js' `getAssetPathFromRoute` + `getDataHref` behaviour:
+ *   `/`            → `/_next/data/<id>/index.json`
+ *   `/about`       → `/_next/data/<id>/about.json`
+ *   `/index`       → `/_next/data/<id>/index/index.json`  (explicit `/index` page)
+ *   `/blog/foo`    → `/_next/data/<id>/blog/foo.json`
+ *
+ * `pagePath` is the resolved page pathname (already including any locale
+ * prefix and dynamic-param substitution), with a leading slash and NO
+ * trailing slash. The function does not URL-encode — the caller is expected
+ * to have produced a server-routable path.
+ */
+declare function buildPagesDataPath(buildId: string, pagePath: string): string;
+/**
+ * Build the full data URL including the basePath, the search string, and the
+ * `/_next/data/<buildId>/<page>.json` segment.
+ *
+ * `pagePath` must already be the resolved pathname (param-substituted,
+ * locale-prefixed where applicable). `search` includes the leading `?`.
+ */
+declare function buildPagesDataHref(basePath: string, buildId: string, pagePath: string, search: string): string;
+/** Result of matching a URL pathname against the registered route patterns. */
+type PagesPatternMatch = {
+  /** The matched route pattern in Next.js bracket format (e.g. `/blog/[slug]`). */pattern: string; /** Dynamic route params extracted from the URL. */
+  params: Record<string, string | string[]>;
+};
+/**
+ * Find the route pattern (Next.js bracket format) that matches `pathname`.
+ *
+ * Patterns are tried in `patterns` order — callers should pre-sort so more
+ * specific patterns come before catch-alls. Returns `null` when no pattern
+ * matches, so the caller can fall back to a hard navigation (this is how
+ * vinext handles routes that exist on the server but are not in the
+ * client-side loader map, e.g. dev-only pages).
+ */
+declare function matchPagesPattern(pathname: string, patterns: readonly string[]): PagesPatternMatch | null;
+//#endregion
+export { buildPagesDataHref, buildPagesDataPath, matchPagesPattern };
+//# sourceMappingURL=pages-data-url.d.ts.map

package/dist/shims/internal/pages-data-url.js

@@ -0,0 +1,73 @@
+import { matchRoutePattern, routePatternParts } from "../../routing/route-pattern.js";
+//#region src/shims/internal/pages-data-url.ts
+/**
+* Client-side helpers for the Pages Router `/_next/data/<buildId>/<page>.json`
+* endpoint.
+*
+* Ported from Next.js:
+*   - `packages/next/src/client/page-loader.ts` (`getDataHref`)
+*   - `packages/next/src/shared/lib/router/utils/get-asset-path-from-route.ts`
+*
+* The server-side counterpart lives in `server/pages-data-route.ts` and parses
+* the URL shape this module generates. Keep the two in sync — they are the
+* wire-format contract between vinext's client navigation and its data
+* endpoint.
+*/
+/**
+* Append `.json` and the `/_next/data/<buildId>` prefix to a page pathname.
+*
+* Mirrors Next.js' `getAssetPathFromRoute` + `getDataHref` behaviour:
+*   `/`            → `/_next/data/<id>/index.json`
+*   `/about`       → `/_next/data/<id>/about.json`
+*   `/index`       → `/_next/data/<id>/index/index.json`  (explicit `/index` page)
+*   `/blog/foo`    → `/_next/data/<id>/blog/foo.json`
+*
+* `pagePath` is the resolved page pathname (already including any locale
+* prefix and dynamic-param substitution), with a leading slash and NO
+* trailing slash. The function does not URL-encode — the caller is expected
+* to have produced a server-routable path.
+*/
+function buildPagesDataPath(buildId, pagePath) {
+	let path = pagePath;
+	if (path.length > 1 && path.endsWith("/")) path = path.slice(0, -1);
+	let asset;
+	if (path === "/") asset = "/index";
+	else if (path === "/index" || path.startsWith("/index/")) asset = "/index" + path;
+	else asset = path;
+	return `/_next/data/${buildId}${asset}.json`;
+}
+/**
+* Build the full data URL including the basePath, the search string, and the
+* `/_next/data/<buildId>/<page>.json` segment.
+*
+* `pagePath` must already be the resolved pathname (param-substituted,
+* locale-prefixed where applicable). `search` includes the leading `?`.
+*/
+function buildPagesDataHref(basePath, buildId, pagePath, search) {
+	const dataPath = buildPagesDataPath(buildId, pagePath);
+	return `${basePath ? basePath : ""}${dataPath}${search}`;
+}
+/**
+* Find the route pattern (Next.js bracket format) that matches `pathname`.
+*
+* Patterns are tried in `patterns` order — callers should pre-sort so more
+* specific patterns come before catch-alls. Returns `null` when no pattern
+* matches, so the caller can fall back to a hard navigation (this is how
+* vinext handles routes that exist on the server but are not in the
+* client-side loader map, e.g. dev-only pages).
+*/
+function matchPagesPattern(pathname, patterns) {
+	const urlParts = pathname.split("/").filter(Boolean);
+	for (const pattern of patterns) {
+		const params = matchRoutePattern(urlParts, routePatternParts(pattern));
+		if (params !== null) return {
+			pattern,
+			params
+		};
+	}
+	return null;
+}
+//#endregion
+export { buildPagesDataHref, buildPagesDataPath, matchPagesPattern };
+
+//# sourceMappingURL=pages-data-url.js.map

package/dist/shims/internal/pages-data-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages-data-url.js","names":[],"sources":["../../../src/shims/internal/pages-data-url.ts"],"sourcesContent":["/**\n * Client-side helpers for the Pages Router `/_next/data/<buildId>/<page>.json`\n * endpoint.\n *\n * Ported from Next.js:\n *   - `packages/next/src/client/page-loader.ts` (`getDataHref`)\n *   - `packages/next/src/shared/lib/router/utils/get-asset-path-from-route.ts`\n *\n * The server-side counterpart lives in `server/pages-data-route.ts` and parses\n * the URL shape this module generates. Keep the two in sync — they are the\n * wire-format contract between vinext's client navigation and its data\n * endpoint.\n */\nimport { matchRoutePattern, routePatternParts } from \"../../routing/route-pattern.js\";\n\n/**\n * Append `.json` and the `/_next/data/<buildId>` prefix to a page pathname.\n *\n * Mirrors Next.js' `getAssetPathFromRoute` + `getDataHref` behaviour:\n *   `/`            → `/_next/data/<id>/index.json`\n *   `/about`       → `/_next/data/<id>/about.json`\n *   `/index`       → `/_next/data/<id>/index/index.json`  (explicit `/index` page)\n *   `/blog/foo`    → `/_next/data/<id>/blog/foo.json`\n *\n * `pagePath` is the resolved page pathname (already including any locale\n * prefix and dynamic-param substitution), with a leading slash and NO\n * trailing slash. The function does not URL-encode — the caller is expected\n * to have produced a server-routable path.\n */\nexport function buildPagesDataPath(buildId: string, pagePath: string): string {\n  // Strip trailing slash except for the root path.\n  let path = pagePath;\n  if (path.length > 1 && path.endsWith(\"/\")) {\n    path = path.slice(0, -1);\n  }\n\n  // Next.js' `getAssetPathFromRoute` denormalisation:\n  //   \"/\"            → \"/index\"\n  //   \"/index\"       → \"/index/index\"\n  //   \"/index/foo\"   → \"/index/index/foo\"\n  // This mirrors `pages/index.tsx → /` and disambiguates an explicit\n  // `pages/index.tsx` nested under a folder.\n  let asset: string;\n  if (path === \"/\") {\n    asset = \"/index\";\n  } else if (path === \"/index\" || path.startsWith(\"/index/\")) {\n    asset = \"/index\" + path;\n  } else {\n    asset = path;\n  }\n\n  return `/_next/data/${buildId}${asset}.json`;\n}\n\n/**\n * Build the full data URL including the basePath, the search string, and the\n * `/_next/data/<buildId>/<page>.json` segment.\n *\n * `pagePath` must already be the resolved pathname (param-substituted,\n * locale-prefixed where applicable). `search` includes the leading `?`.\n */\nexport function buildPagesDataHref(\n  basePath: string,\n  buildId: string,\n  pagePath: string,\n  search: string,\n): string {\n  const dataPath = buildPagesDataPath(buildId, pagePath);\n  const prefix = basePath ? basePath : \"\";\n  return `${prefix}${dataPath}${search}`;\n}\n\n/** Result of matching a URL pathname against the registered route patterns. */\ntype PagesPatternMatch = {\n  /** The matched route pattern in Next.js bracket format (e.g. `/blog/[slug]`). */\n  pattern: string;\n  /** Dynamic route params extracted from the URL. */\n  params: Record<string, string | string[]>;\n};\n\n/**\n * Find the route pattern (Next.js bracket format) that matches `pathname`.\n *\n * Patterns are tried in `patterns` order — callers should pre-sort so more\n * specific patterns come before catch-alls. Returns `null` when no pattern\n * matches, so the caller can fall back to a hard navigation (this is how\n * vinext handles routes that exist on the server but are not in the\n * client-side loader map, e.g. dev-only pages).\n */\nexport function matchPagesPattern(\n  pathname: string,\n  patterns: readonly string[],\n): PagesPatternMatch | null {\n  const urlParts = pathname.split(\"/\").filter(Boolean);\n  for (const pattern of patterns) {\n    const patternParts = routePatternParts(pattern);\n    const params = matchRoutePattern(urlParts, patternParts);\n    if (params !== null) {\n      return { pattern, params };\n    }\n  }\n  return null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,mBAAmB,SAAiB,UAA0B;CAE5E,IAAI,OAAO;CACX,IAAI,KAAK,SAAS,KAAK,KAAK,SAAS,IAAI,EACvC,OAAO,KAAK,MAAM,GAAG,GAAG;CAS1B,IAAI;CACJ,IAAI,SAAS,KACX,QAAQ;MACH,IAAI,SAAS,YAAY,KAAK,WAAW,UAAU,EACxD,QAAQ,WAAW;MAEnB,QAAQ;CAGV,OAAO,eAAe,UAAU,MAAM;;;;;;;;;AAUxC,SAAgB,mBACd,UACA,SACA,UACA,QACQ;CACR,MAAM,WAAW,mBAAmB,SAAS,SAAS;CAEtD,OAAO,GADQ,WAAW,WAAW,KAClB,WAAW;;;;;;;;;;;AAoBhC,SAAgB,kBACd,UACA,UAC0B;CAC1B,MAAM,WAAW,SAAS,MAAM,IAAI,CAAC,OAAO,QAAQ;CACpD,KAAK,MAAM,WAAW,UAAU;EAE9B,MAAM,SAAS,kBAAkB,UADZ,kBAAkB,QACgB,CAAC;EACxD,IAAI,WAAW,MACb,OAAO;GAAE;GAAS;GAAQ;;CAG9B,OAAO"}

package/dist/shims/link.d.ts

@@ -22,7 +22,14 @@ type LinkProps = {
    */
   unstable_dynamicOnHover?: boolean; /** Whether to pass the href to the child element */
   passHref?: boolean; /** Scroll to top on navigation (default: true) */
-  scroll?: boolean; /** Locale for i18n (used for locale-prefixed URLs) */
+  scroll?: boolean;
+  /**
+   * Pages Router: update the URL without re-running data fetching methods
+   * (getServerSideProps / getStaticProps / getInitialProps). The shallow change
+   * still triggers the route change events and updates `router.query`. Only
+   * applies to navigations within the same page. No-op on the App Router.
+   */
+  shallow?: boolean; /** Locale for i18n (used for locale-prefixed URLs) */
   locale?: string | false; /** Called before navigation happens (Next.js 16). Return value is ignored. */
   onNavigate?: (event: NavigateEvent) => void;
   children?: React.ReactNode;
@@ -44,6 +51,10 @@ type LinkStatusContextValue = {
 declare function useLinkStatus(): LinkStatusContextValue;
 declare function resolveLinkPrefetchMode(prefetchProp: LinkProps["prefetch"], isDangerous: boolean): LinkPrefetchMode;
 declare function canAutoPrefetchFullAppRoute(href: string): boolean;
+declare function resolveAutoAppRoutePrefetch(href: string): {
+  cacheForNavigation: boolean;
+  shouldPrefetch: boolean;
+};
 declare const Link: React.ForwardRefExoticComponent<{
   href: string | {
     pathname?: string;
@@ -58,11 +69,18 @@ declare const Link: React.ForwardRefExoticComponent<{
    */
   unstable_dynamicOnHover?: boolean; /** Whether to pass the href to the child element */
   passHref?: boolean; /** Scroll to top on navigation (default: true) */
-  scroll?: boolean; /** Locale for i18n (used for locale-prefixed URLs) */
+  scroll?: boolean;
+  /**
+   * Pages Router: update the URL without re-running data fetching methods
+   * (getServerSideProps / getStaticProps / getInitialProps). The shallow change
+   * still triggers the route change events and updates `router.query`. Only
+   * applies to navigations within the same page. No-op on the App Router.
+   */
+  shallow?: boolean; /** Locale for i18n (used for locale-prefixed URLs) */
   locale?: string | false; /** Called before navigation happens (Next.js 16). Return value is ignored. */
   onNavigate?: (event: NavigateEvent) => void;
   children?: React.ReactNode;
 } & Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> & React.RefAttributes<HTMLAnchorElement>>;
 //#endregion
-export { canAutoPrefetchFullAppRoute, Link as default, resolveLinkPrefetchMode, useLinkStatus };
+export { canAutoPrefetchFullAppRoute, Link as default, resolveAutoAppRoutePrefetch, resolveLinkPrefetchMode, useLinkStatus };
 //# sourceMappingURL=link.d.ts.map