@next-box/link-extra 0.1.0 → 0.1.2

package/README.md

@@ -1,8 +1,144 @@
 # @next-box/link-extra
 
-A collection of link components for use primarily with Next.js.
+A configurable link component for React applications, primarily designed for Next.js.
 
 [![npm version](https://badge.fury.io/js/%40next-box%2Flink-extra.svg)](https://badge.fury.io/js/%40next-box%2Flink-extra)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-The use of React server components has flipped the traditional UX pattern of navigating to a page and waiting for the content to load on its head. Now, the potential delay is prior to the redirection, while the server render is happening. This transition can sometimes be handled by the use of the `loading.tsx` file, but not always.
+Next.js is a powerful framework for building modern React applications, particularly with its support for React Server Components and server-side rendering. However, these features can introduce some differences in navigation behaviour compared with traditional client-side applications.
+
+Client-side navigation can sometimes feel unresponsive when the destination requires server-side work, with the browser waiting for the new route to begin rendering before the UI changes. This has been discussed in the Next.js community, including [Slow route navigation](https://github.com/vercel/next.js/discussions/65150) and [How to indicate loading during pagination](https://github.com/vercel/next.js/discussions/55481).
+
+Next.js also maintains a client-side Router Cache to improve navigation performance. While this is useful for many applications, there are cases where an application needs to ensure that navigation retrieves the latest version of a route. The ability to opt out of this client-side caching has been discussed in [Opt-out of client cache](https://github.com/vercel/next.js/discussions/54162), and the distinction between the Router Cache and server-side caching is discussed in [Deep Dive: Caching and Revalidating](https://github.com/vercel/next.js/discussions/54075).
+
+Finally, applications often have their own link components and design systems. Integrating these with Next.js `Link` can be awkward, particularly when an application needs the `href` applied to its own anchor element rather than having Next.js render the anchor itself. This has been discussed in the Next.js community, including [Add back `passHref` to the new next/link component](https://github.com/vercel/next.js/discussions/49508) and [Remove `legacyBehavior` from Link component on Next.js 15](https://github.com/vercel/next.js/discussions/67987).
+
+`@next-box/link-extra` provides a wrapper around the Next.js `Link` component that addresses these concerns while retaining Next.js client-side navigation.
+
+## What it provides
+
+### Loading feedback
+
+A navigation can take some time to begin rendering, particularly when the destination requires server-side work. `@next-box/link-extra` can display a custom loading component if navigation has not completed within a configurable timeout.
+
+If the route transition completes before the timeout, no loading indicator is displayed. If it takes longer, the loading component is rendered automatically.
+
+### Router cache control
+
+`@next-box/link-extra` provides the `disableRouterCache` prop for cases where an application needs to bypass the Next.js client-side Router Cache.
+
+When enabled, the link adds a cache-busting query parameter to the destination URL. This is enabled by default.
+
+### Custom link components
+
+The library separates the Next.js navigation link from the component used to render the actual link.
+
+This allows applications to provide their own link component for styling and design-system requirements while retaining Next.js navigation behaviour.
+
+## Installation
+
+```shell
+npm add @next-box/link-extra
+```
+
+## Usage
+
+### Create a link provider
+
+`LinkProvider` supplies the Next.js link, your own link component, and the loading component used by `Link`.
+
+It also receives the current pathname so that it can detect when a navigation has completed.
+
+```tsx
+'use client';
+
+import Link from 'next/link';
+import { usePathname } from 'next/navigation';
+import {
+  LinkProvider,
+} from '@next-box/link-extra';
+
+const LinkProviderWrapper = ({
+  children,
+}: {
+  children: ReactNode;
+}) => {
+  const pathname = usePathname();
+
+  return (
+    <LinkProvider
+      LoadingComponent={Loading}
+      NextLink={Link}
+      OwnLink={YourLink}
+      pathname={pathname}
+    >
+      {children}
+    </LinkProvider>
+  );
+};
+```
+
+`LinkProvider` is a Client Component. The wrapper above supplies the current pathname and the link component implementations from client code; these component functions cannot be passed as props from a Server Component.
+
+### Render a link
+
+Once the provider has been configured, use the `Link` component in place of your normal Next.js link.
+
+```tsx
+import { Link } from '@next-box/link-extra';
+
+const Component = () => {
+  return (
+    <Link href="/dashboard">
+      Dashboard
+    </Link>
+  );
+};
+```
+
+### Disable Router Cache
+
+Router cache busting is enabled by default.
+
+To allow Next.js to use its normal Router Cache behaviour for an individual link, set `disableRouterCache` to `false`:
+
+```tsx
+<Link
+  href="/dashboard"
+  disableRouterCache={false}
+>
+  Dashboard
+</Link>
+```
+
+### Configure loading behaviour
+
+The loading timeout defaults to `500ms`. This can be changed through `LinkProvider`:
+
+```tsx
+<LinkProvider
+  LoadingComponent={Loading}
+  NextLink={Link}
+  OwnLink={YourLink}
+  pathname={pathname}
+  loadingTimeout={1000}
+>
+  {children}
+</LinkProvider>
+```
+
+The loading component is only rendered when a link navigation remains in progress beyond the configured timeout.
+
+### Prevent loading for a link
+
+The loading state is only triggered when the link represents navigation to a different URL and the click has not been prevented.
+
+This means links that point to the current location, or clicks where `event.preventDefault()` has been called, do not trigger the loading indicator.
+
+## Changelog
+
+See the [changelog](../../CHANGELOG.md) for features, fixes, and other changes included in each major, minor, and patch release.
+
+## License
+
+`@next-box/link-extra` is [MIT Licensed](LICENSE).

package/dist/cjs/Link.cjs

@@ -0,0 +1,3 @@
+"use client";
+"use strict";var e=require("react/jsx-runtime"),r=require("./helpers.cjs"),c=require("./useLinkExtra.cjs");exports.Link=({children:i,disableRouterCache:n=!0,href:s="#",onClick:t,prefetch:a=!1,scroll:l=!1,...h})=>{const{NextLink:u,OwnLink:o,onLinkClicked:d}=c.useLinkExtra();return n&&(s=r.addCacheBusterQueryParam(s)),e.jsx(u,{href:s,legacyBehavior:!0,passHref:!0,prefetch:a,scroll:l,children:e.jsx(o,{onClick:e=>{t&&t(e),r.shouldUrlAndLocationMatch(s)||e.defaultPrevented||d()},...h,children:i})})};
+//# sourceMappingURL=Link.cjs.map

package/dist/cjs/Link.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Link.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/cjs/LinkProvider.cjs

@@ -0,0 +1,3 @@
+"use client";
+"use strict";var e=require("react/jsx-runtime"),r=require("react");const n=r.createContext({});exports.LinkContext=n,exports.LinkProvider=({LoadingComponent:t,NextLink:u,OwnLink:l,children:c,loadingTimeout:i=500,pathname:o})=>{const s=r.useRef(null),[a,x]=r.useState(!1),k=r.useCallback(()=>{null!==s.current&&clearTimeout(s.current),s.current=setTimeout(()=>{s.current=null,x(!0)},i)},[i]);return r.useEffect(()=>(null!==s.current&&(clearTimeout(s.current),s.current=null),x(!1),scroll(0,0),()=>{null!==s.current&&(clearTimeout(s.current),s.current=null)}),[o]),e.jsx(n,{value:{NextLink:u,OwnLink:l,onLinkClicked:()=>{k()}},children:e.jsxs(e.Fragment,{children:[c,a?e.jsx(t,{}):void 0]})})};
+//# sourceMappingURL=LinkProvider.cjs.map

package/dist/cjs/LinkProvider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkProvider.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/cjs/helpers.cjs

@@ -0,0 +1,2 @@
+"use strict";var a=require("nanoid");const r=(a,r=!1)=>{const e=new URLSearchParams(a).entries().filter(([a])=>!r||"y"!==a).toArray().toSorted(([a,r],[e,o])=>a.localeCompare(e)||r.localeCompare(o));return new URLSearchParams(e).toString()};exports.addCacheBusterQueryParam=e=>{if(!globalThis.location)return e;const o=URL.parse(e,location.origin);if(!o)return e;const t=new URLSearchParams(location.search).get("y"),{pathname:n,search:c}=o,i=new URLSearchParams(c);return n===location.pathname&&r(c,!0)===r(location.search,!0)?i.set("y",t??a.nanoid()):i.set("y",a.nanoid()),`${n}?${i.toString()}`},exports.shouldUrlAndLocationMatch=a=>{if(!globalThis.location)return!1;const e=URL.parse(a,location.origin);return!!e&&(e.pathname===location.pathname&&r(e.search,!0)===r(location.search,!0))};
+//# sourceMappingURL=helpers.cjs.map

package/dist/cjs/helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.cjs","sources":["../../src/helpers.ts"],"sourcesContent":["import { nanoid } from 'nanoid';\n\nconst normalizeSearchParams = (search: string, toOmitCacheBuster = false): string => {\n  const entries = new URLSearchParams(search)\n    .entries()\n    .filter(([key]) => !toOmitCacheBuster || key !== 'y')\n    .toArray()\n    .toSorted(([keyA, valueA], [keyB, valueB]) => keyA.localeCompare(keyB) || valueA.localeCompare(valueB));\n\n  return new URLSearchParams(entries).toString();\n};\n\nexport const shouldUrlAndLocationMatch = (url: string): boolean => {\n  // It is possible for this to be undefined\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (!globalThis.location) {\n    return false;\n  }\n\n  const parsedUrl = URL.parse(url, location.origin);\n\n  if (!parsedUrl) {\n    return false;\n  }\n\n  return (\n    parsedUrl.pathname === location.pathname &&\n    normalizeSearchParams(parsedUrl.search, true) === normalizeSearchParams(location.search, true)\n  );\n};\n\nexport const addCacheBusterQueryParam = (url: string): string => {\n  // It is possible for this to be undefined\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (!globalThis.location) {\n    return url;\n  }\n\n  const parsedUrl = URL.parse(url, location.origin);\n\n  if (!parsedUrl) {\n    return url;\n  }\n\n  const locationSearchParams = new URLSearchParams(location.search);\n  const locationCacheBusterSearchParam = locationSearchParams.get('y');\n\n  const { pathname, search } = parsedUrl;\n  const searchParams = new URLSearchParams(search);\n\n  if (\n    pathname === location.pathname &&\n    normalizeSearchParams(search, true) === normalizeSearchParams(location.search, true)\n  ) {\n    searchParams.set('y', locationCacheBusterSearchParam ?? nanoid());\n  } else {\n    searchParams.set('y', nanoid());\n  }\n\n  return `${pathname}?${searchParams.toString()}`;\n};\n"],"names":["normalizeSearchParams","search","toOmitCacheBuster","entries","URLSearchParams","filter","key","toArray","toSorted","keyA","valueA","keyB","valueB","localeCompare","toString","url","globalThis","location","parsedUrl","URL","parse","origin","locationCacheBusterSearchParam","get","pathname","searchParams","set","nanoid"],"mappings":"qCAEA,MAAMA,EAAwB,CAACC,EAAgBC,GAAoB,KACjE,MAAMC,EAAU,IAAIC,gBAAgBH,GACjCE,UACAE,OAAO,EAAEC,MAAUJ,GAA6B,MAARI,GACxCC,UACAC,SAAS,EAAEC,EAAMC,IAAUC,EAAMC,KAAYH,EAAKI,cAAcF,IAASD,EAAOG,cAAcD,IAEjG,OAAO,IAAIR,gBAAgBD,GAASW,6CAsBGC,IAGvC,IAAKC,WAAWC,SACd,OAAOF,EAGT,MAAMG,EAAYC,IAAIC,MAAML,EAAKE,SAASI,QAE1C,IAAKH,EACH,OAAOH,EAGT,MACMO,EADuB,IAAIlB,gBAAgBa,SAAShB,QACEsB,IAAI,MAE1DC,SAAEA,EAAQvB,OAAEA,GAAWiB,EACvBO,EAAe,IAAIrB,gBAAgBH,GAWzC,OAREuB,IAAaP,SAASO,UACtBxB,EAAsBC,GAAQ,KAAUD,EAAsBiB,SAAShB,QAAQ,GAE/EwB,EAAaC,IAAI,IAAKJ,GAAkCK,EAAAA,UAExDF,EAAaC,IAAI,IAAKC,EAAAA,UAGjB,GAAGH,KAAYC,EAAaX,gDA/CKC,IAGxC,IAAKC,WAAWC,SACd,OAAO,EAGT,MAAMC,EAAYC,IAAIC,MAAML,EAAKE,SAASI,QAE1C,QAAKH,IAKHA,EAAUM,WAAaP,SAASO,UAChCxB,EAAsBkB,EAAUjB,QAAQ,KAAUD,EAAsBiB,SAAShB,QAAQ"}

package/dist/cjs/index.cjs

@@ -1,2 +1,2 @@
-"use strict";var e=require("react/jsx-runtime"),r=require("react"),n=require("nanoid");const t=r.createContext({}),a=e=>{if(!globalThis.location)return!1;const r=URL.parse(e,location.origin);if(!r)return!1;const{pathname:n,search:t}=r,a=new URLSearchParams(t);a.has("y")&&a.delete("y");const o=new URLSearchParams(location.search);return o.has("y")&&o.delete("y"),`${n}?${a.toString()}`==`${location.pathname}?${o.toString()}`},o=e=>{if(!globalThis.location)return e;const r=URL.parse(e,location.origin);if(!r)return e;const t=new URLSearchParams(location.search),a=t.get("y");a&&t.delete("y");const{pathname:o,search:i}=r,c=new URLSearchParams(i);return`${o}?${i}`==`${location.pathname}?${t.toString()}`?c.set("y",a??n.nanoid()):c.set("y",n.nanoid()),`${o}?${c.toString()}`},i=()=>r.use(t);exports.Link=({children:r,disableRouterCache:n=!0,href:t="#",onClick:c,prefetch:s=!1,scroll:l=!1,...u})=>{const{NextLink:h,OwnLink:d,onLinkClicked:L}=i();return n&&(t=o(t)),e.jsx(h,{href:t,legacyBehavior:!0,passHref:!0,prefetch:s,scroll:l,children:e.jsx(d,{onClick:e=>{c&&c(e),a(t)||e.defaultPrevented||L()},...u,children:r})})},exports.LinkContext=t,exports.LinkProvider=({LoadingComponent:n,NextLink:a,OwnLink:o,children:i,loadingTimeout:c=500,pathname:s})=>{const l=r.useRef(null),[u,h]=r.useState(!1),d=r.useCallback(()=>{l.current&&clearTimeout(l.current),l.current=setTimeout(()=>{h(!0)},c)},[c]);return r.useEffect(()=>{l.current&&clearTimeout(l.current),h(!1),scroll(0,0)},[s]),e.jsx(t,{value:{NextLink:a,OwnLink:o,onLinkClicked:()=>{d()}},children:e.jsxs(e.Fragment,{children:[i,u?e.jsx(n,{}):void 0]})})},exports.addCacheBusterQueryParam=o,exports.shouldUrlAndLocationMatch=a,exports.useLinkExtra=i;
+"use strict";var r=require("./LinkProvider.cjs"),e=require("./Link.cjs"),i=require("./helpers.cjs"),t=require("./useLinkExtra.cjs");exports.LinkContext=r.LinkContext,exports.LinkProvider=r.LinkProvider,exports.Link=e.Link,exports.addCacheBusterQueryParam=i.addCacheBusterQueryParam,exports.shouldUrlAndLocationMatch=i.shouldUrlAndLocationMatch,exports.useLinkExtra=t.useLinkExtra;
 //# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../src/LinkProvider.tsx","../../src/helpers.ts","../../src/useLinkExtra.ts","../../src/Link.tsx"],"sourcesContent":["import type Link from 'next/link.js';\nimport {\n  type ComponentType,\n  type FC,\n  type ReactNode,\n  createContext,\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n} from 'react';\nimport { type LinkContextData, type NextLinkComponent, type OwnLinkProps } from '#types.js';\n\n// Context requires an initial value, but this is set in the provider so casting\n// eslint-disable-next-line @typescript-eslint/consistent-type-assertions\nexport const LinkContext = createContext<LinkContextData>({} as LinkContextData);\n\nexport type LinkProviderProps = {\n  LoadingComponent: ComponentType;\n  NextLink: typeof Link;\n  OwnLink: ComponentType<OwnLinkProps>;\n  children: ReactNode | ReactNode[];\n  loadingTimeout?: number;\n  pathname: string;\n};\n\nexport const LinkProvider: FC<LinkProviderProps> = ({\n  LoadingComponent,\n  NextLink,\n  OwnLink,\n  children,\n  loadingTimeout = 500,\n  pathname,\n}) => {\n  const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const [showLoading, setShowLoading] = useState<boolean>(false);\n\n  const onLinkClicked = useCallback(() => {\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n    }\n\n    timeoutRef.current = setTimeout(() => {\n      setShowLoading(true);\n    }, loadingTimeout);\n  }, [loadingTimeout]);\n\n  useEffect(() => {\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n    }\n\n    // This is setting state based on pathname change\n    // eslint-disable-next-line react-hooks/set-state-in-effect, @eslint-react/set-state-in-effect\n    setShowLoading(false);\n    scroll(0, 0);\n  }, [pathname]);\n\n  return (\n    <LinkContext\n      value={{\n        // Casting due to issues marrying up prop type and context type\n        // eslint-disable-next-line @typescript-eslint/consistent-type-assertions\n        NextLink: NextLink as unknown as NextLinkComponent,\n        OwnLink,\n        onLinkClicked: () => {\n          onLinkClicked();\n        },\n      }}\n    >\n      <>\n        {children}\n        {showLoading ? <LoadingComponent /> : undefined}\n      </>\n    </LinkContext>\n  );\n};\n","import { nanoid } from 'nanoid';\n\nexport const shouldUrlAndLocationMatch = (url: string): boolean => {\n  // It is possible for this to be undefined\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (!globalThis.location) {\n    return false;\n  }\n\n  const parsedUrl = URL.parse(url, location.origin);\n\n  if (!parsedUrl) {\n    return false;\n  }\n\n  const { pathname, search } = parsedUrl;\n  const urlSearchParams = new URLSearchParams(search);\n\n  if (urlSearchParams.has('y')) {\n    urlSearchParams.delete('y');\n  }\n\n  const locationSearchParams = new URLSearchParams(location.search);\n\n  if (locationSearchParams.has('y')) {\n    locationSearchParams.delete('y');\n  }\n\n  return `${pathname}?${urlSearchParams.toString()}` === `${location.pathname}?${locationSearchParams.toString()}`;\n};\n\nexport const addCacheBusterQueryParam = (url: string): string => {\n  // It is possible for this to be undefined\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (!globalThis.location) {\n    return url;\n  }\n\n  const parsedUrl = URL.parse(url, location.origin);\n\n  if (!parsedUrl) {\n    return url;\n  }\n\n  const locationSearchParams = new URLSearchParams(location.search);\n  const locationCacheBusterSearchParam = locationSearchParams.get('y');\n\n  if (locationCacheBusterSearchParam) {\n    locationSearchParams.delete('y');\n  }\n\n  const { pathname, search } = parsedUrl;\n  const searchParams = new URLSearchParams(search);\n\n  if (`${pathname}?${search}` === `${location.pathname}?${locationSearchParams.toString()}`) {\n    searchParams.set('y', locationCacheBusterSearchParam ?? nanoid());\n  } else {\n    searchParams.set('y', nanoid());\n  }\n\n  return `${pathname}?${searchParams.toString()}`;\n};\n","import { use } from 'react';\nimport { type LinkContextData } from '#types.ts';\nimport { LinkContext } from './LinkProvider.tsx';\n\nexport const useLinkExtra = (): LinkContextData => {\n  return use(LinkContext);\n};\n","import { type AnchorHTMLAttributes, type JSX, type ReactNode } from 'react';\nimport { addCacheBusterQueryParam, shouldUrlAndLocationMatch } from '#helpers.ts';\nimport { useLinkExtra } from './useLinkExtra.ts';\n\nexport type LinkProps<T extends object> = {\n  children: ReactNode;\n  disableRouterCache?: boolean;\n  href?: string;\n  prefetch?: boolean;\n  scroll?: boolean;\n} & AnchorHTMLAttributes<HTMLAnchorElement> &\n  T;\n\nexport const Link = <T extends object>({\n  children,\n  disableRouterCache = true,\n  href = '#',\n  onClick,\n  prefetch = false,\n  scroll = false,\n  ...otherProps\n}: LinkProps<T>): JSX.Element => {\n  // This and the two other disables below are false positives\n  // eslint-disable-next-line @eslint-react/static-components\n  const { NextLink, OwnLink, onLinkClicked } = useLinkExtra();\n\n  if (disableRouterCache) {\n    href = addCacheBusterQueryParam(href);\n  }\n\n  return (\n    // This needs to remain: https://github.com/vercel/next.js/discussions/76329\n    // eslint-disable-next-line @typescript-eslint/no-deprecated, @eslint-react/static-components\n    <NextLink href={href} legacyBehavior passHref prefetch={prefetch} scroll={scroll}>\n      <OwnLink // eslint-disable-line @eslint-react/static-components\n        onClick={event => {\n          if (onClick) {\n            onClick(event);\n          }\n\n          if (!shouldUrlAndLocationMatch(href) && !event.defaultPrevented) {\n            onLinkClicked();\n          }\n        }}\n        {...otherProps}\n      >\n        {children}\n      </OwnLink>\n    </NextLink>\n  );\n};\n"],"names":["LinkContext","createContext","shouldUrlAndLocationMatch","url","globalThis","location","parsedUrl","URL","parse","origin","pathname","search","urlSearchParams","URLSearchParams","has","delete","locationSearchParams","toString","addCacheBusterQueryParam","locationCacheBusterSearchParam","get","searchParams","set","nanoid","useLinkExtra","use","children","disableRouterCache","href","onClick","prefetch","scroll","otherProps","NextLink","OwnLink","onLinkClicked","_jsx","legacyBehavior","passHref","event","defaultPrevented","LoadingComponent","loadingTimeout","timeoutRef","useRef","showLoading","setShowLoading","useState","useCallback","current","clearTimeout","setTimeout","useEffect","value","_jsxs","_Fragment","undefined"],"mappings":"uFAeO,MAAMA,EAAcC,EAAAA,cAA+B,CAAA,GCb7CC,EAA6BC,IAGxC,IAAKC,WAAWC,SACd,OAAO,EAGT,MAAMC,EAAYC,IAAIC,MAAML,EAAKE,SAASI,QAE1C,IAAKH,EACH,OAAO,EAGT,MAAMI,SAAEA,EAAQC,OAAEA,GAAWL,EACvBM,EAAkB,IAAIC,gBAAgBF,GAExCC,EAAgBE,IAAI,MACtBF,EAAgBG,OAAO,KAGzB,MAAMC,EAAuB,IAAIH,gBAAgBR,SAASM,QAM1D,OAJIK,EAAqBF,IAAI,MAC3BE,EAAqBD,OAAO,KAGvB,GAAGL,KAAYE,EAAgBK,cAAiB,GAAGZ,SAASK,YAAYM,EAAqBC,cAGzFC,EAA4Bf,IAGvC,IAAKC,WAAWC,SACd,OAAOF,EAGT,MAAMG,EAAYC,IAAIC,MAAML,EAAKE,SAASI,QAE1C,IAAKH,EACH,OAAOH,EAGT,MAAMa,EAAuB,IAAIH,gBAAgBR,SAASM,QACpDQ,EAAiCH,EAAqBI,IAAI,KAE5DD,GACFH,EAAqBD,OAAO,KAG9B,MAAML,SAAEA,EAAQC,OAAEA,GAAWL,EACvBe,EAAe,IAAIR,gBAAgBF,GAQzC,MANI,GAAGD,KAAYC,KAAa,GAAGN,SAASK,YAAYM,EAAqBC,aAC3EI,EAAaC,IAAI,IAAKH,GAAkCI,EAAAA,UAExDF,EAAaC,IAAI,IAAKC,EAAAA,UAGjB,GAAGb,KAAYW,EAAaJ,cCxDxBO,EAAe,IACnBC,EAAAA,IAAIzB,gBCQO,EAClB0B,WACAC,sBAAqB,EACrBC,OAAO,IACPC,UACAC,YAAW,EACXC,UAAS,KACNC,MAIH,MAAMC,SAAEA,EAAQC,QAAEA,EAAOC,cAAEA,GAAkBX,IAM7C,OAJIG,IACFC,EAAOV,EAAyBU,IAMhCQ,EAAAA,IAACH,EAAAA,CAASL,KAAMA,EAAMS,gBAAc,EAACC,UAAQ,EAACR,SAAUA,EAAUC,OAAQA,WACxEK,EAAAA,IAACF,GACCL,QAASU,IACHV,GACFA,EAAQU,GAGLrC,EAA0B0B,IAAUW,EAAMC,kBAC7CL,QAGAH,EAEHN,SAAAA,kDHpB0C,EACjDe,mBACAR,WACAC,UACAR,WACAgB,iBAAiB,IACjBhC,eAEA,MAAMiC,EAAaC,EAAAA,OAA6C,OACzDC,EAAaC,GAAkBC,EAAAA,UAAkB,GAElDZ,EAAgBa,EAAAA,YAAY,KAC5BL,EAAWM,SACbC,aAAaP,EAAWM,SAG1BN,EAAWM,QAAUE,WAAW,KAC9BL,GAAe,IACdJ,IACF,CAACA,IAaJ,OAXAU,EAAAA,UAAU,KACJT,EAAWM,SACbC,aAAaP,EAAWM,SAK1BH,GAAe,GACff,OAAO,EAAG,IACT,CAACrB,IAGF0B,EAAAA,IAACpC,EAAAA,CACCqD,MAAO,CAGLpB,SAAUA,EACVC,UACAC,cAAe,KACbA,eAIJmB,EAAAA,KAAAC,WAAA,WACG7B,EACAmB,EAAcT,EAAAA,IAACK,EAAAA,CAAAA,QAAsBe"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/cjs/useLinkExtra.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("react"),r=require("./LinkProvider.cjs");exports.useLinkExtra=()=>e.use(r.LinkContext);
+//# sourceMappingURL=useLinkExtra.cjs.map

package/dist/cjs/useLinkExtra.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLinkExtra.cjs","sources":["../../src/useLinkExtra.ts"],"sourcesContent":["import { use } from 'react';\nimport { type LinkContextData } from '#types.ts';\nimport { LinkContext } from './LinkProvider.tsx';\n\nexport const useLinkExtra = (): LinkContextData => {\n  return use(LinkContext);\n};\n"],"names":["use","LinkContext"],"mappings":"yFAI4B,IACnBA,EAAAA,IAAIC,EAAAA"}

package/dist/esm/Link.mjs

@@ -0,0 +1,3 @@
+"use client";
+import{jsx as e}from"react/jsx-runtime";import{addCacheBusterQueryParam as r,shouldUrlAndLocationMatch as i}from"./helpers.mjs";import{useLinkExtra as n}from"./useLinkExtra.mjs";const o=({children:o,disableRouterCache:t=!0,href:c="#",onClick:l,prefetch:s=!1,scroll:h=!1,...f})=>{const{NextLink:m,OwnLink:a,onLinkClicked:p}=n();return t&&(c=r(c)),e(m,{href:c,legacyBehavior:!0,passHref:!0,prefetch:s,scroll:h,children:e(a,{onClick:e=>{l&&l(e),i(c)||e.defaultPrevented||p()},...f,children:o})})};export{o as Link};
+//# sourceMappingURL=Link.mjs.map

package/dist/esm/Link.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Link.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/esm/LinkProvider.mjs

@@ -0,0 +1,3 @@
+"use client";
+import{jsx as n,jsxs as r,Fragment as e}from"react/jsx-runtime";import{createContext as t,useRef as l,useState as u,useCallback as c,useEffect as i}from"react";const o=t({}),m=({LoadingComponent:t,NextLink:m,OwnLink:a,children:d,loadingTimeout:k=500,pathname:L})=>{const p=l(null),[s,T]=u(!1),h=c(()=>{null!==p.current&&clearTimeout(p.current),p.current=setTimeout(()=>{p.current=null,T(!0)},k)},[k]);return i(()=>(null!==p.current&&(clearTimeout(p.current),p.current=null),T(!1),scroll(0,0),()=>{null!==p.current&&(clearTimeout(p.current),p.current=null)}),[L]),n(o,{value:{NextLink:m,OwnLink:a,onLinkClicked:()=>{h()}},children:r(e,{children:[d,s?n(t,{}):void 0]})})};export{o as LinkContext,m as LinkProvider};
+//# sourceMappingURL=LinkProvider.mjs.map

package/dist/esm/LinkProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkProvider.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/esm/helpers.mjs

@@ -0,0 +1,2 @@
+import{nanoid as a}from"nanoid";const r=(a,r=!1)=>{const o=new URLSearchParams(a).entries().filter(([a])=>!r||"y"!==a).toArray().toSorted(([a,r],[o,t])=>a.localeCompare(o)||r.localeCompare(t));return new URLSearchParams(o).toString()},o=a=>{if(!globalThis.location)return!1;const o=URL.parse(a,location.origin);return!!o&&(o.pathname===location.pathname&&r(o.search,!0)===r(location.search,!0))},t=o=>{if(!globalThis.location)return o;const t=URL.parse(o,location.origin);if(!t)return o;const e=new URLSearchParams(location.search).get("y"),{pathname:n,search:c}=t,i=new URLSearchParams(c);return n===location.pathname&&r(c,!0)===r(location.search,!0)?i.set("y",e??a()):i.set("y",a()),`${n}?${i.toString()}`};export{t as addCacheBusterQueryParam,o as shouldUrlAndLocationMatch};
+//# sourceMappingURL=helpers.mjs.map

package/dist/esm/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","sources":["../../src/helpers.ts"],"sourcesContent":["import { nanoid } from 'nanoid';\n\nconst normalizeSearchParams = (search: string, toOmitCacheBuster = false): string => {\n  const entries = new URLSearchParams(search)\n    .entries()\n    .filter(([key]) => !toOmitCacheBuster || key !== 'y')\n    .toArray()\n    .toSorted(([keyA, valueA], [keyB, valueB]) => keyA.localeCompare(keyB) || valueA.localeCompare(valueB));\n\n  return new URLSearchParams(entries).toString();\n};\n\nexport const shouldUrlAndLocationMatch = (url: string): boolean => {\n  // It is possible for this to be undefined\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (!globalThis.location) {\n    return false;\n  }\n\n  const parsedUrl = URL.parse(url, location.origin);\n\n  if (!parsedUrl) {\n    return false;\n  }\n\n  return (\n    parsedUrl.pathname === location.pathname &&\n    normalizeSearchParams(parsedUrl.search, true) === normalizeSearchParams(location.search, true)\n  );\n};\n\nexport const addCacheBusterQueryParam = (url: string): string => {\n  // It is possible for this to be undefined\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (!globalThis.location) {\n    return url;\n  }\n\n  const parsedUrl = URL.parse(url, location.origin);\n\n  if (!parsedUrl) {\n    return url;\n  }\n\n  const locationSearchParams = new URLSearchParams(location.search);\n  const locationCacheBusterSearchParam = locationSearchParams.get('y');\n\n  const { pathname, search } = parsedUrl;\n  const searchParams = new URLSearchParams(search);\n\n  if (\n    pathname === location.pathname &&\n    normalizeSearchParams(search, true) === normalizeSearchParams(location.search, true)\n  ) {\n    searchParams.set('y', locationCacheBusterSearchParam ?? nanoid());\n  } else {\n    searchParams.set('y', nanoid());\n  }\n\n  return `${pathname}?${searchParams.toString()}`;\n};\n"],"names":["normalizeSearchParams","search","toOmitCacheBuster","entries","URLSearchParams","filter","key","toArray","toSorted","keyA","valueA","keyB","valueB","localeCompare","toString","shouldUrlAndLocationMatch","url","globalThis","location","parsedUrl","URL","parse","origin","pathname","addCacheBusterQueryParam","locationCacheBusterSearchParam","get","searchParams","set","nanoid"],"mappings":"gCAEA,MAAMA,EAAwB,CAACC,EAAgBC,GAAoB,KACjE,MAAMC,EAAU,IAAIC,gBAAgBH,GACjCE,UACAE,OAAO,EAAEC,MAAUJ,GAA6B,MAARI,GACxCC,UACAC,SAAS,EAAEC,EAAMC,IAAUC,EAAMC,KAAYH,EAAKI,cAAcF,IAASD,EAAOG,cAAcD,IAEjG,OAAO,IAAIR,gBAAgBD,GAASW,YAGzBC,EAA6BC,IAGxC,IAAKC,WAAWC,SACd,OAAO,EAGT,MAAMC,EAAYC,IAAIC,MAAML,EAAKE,SAASI,QAE1C,QAAKH,IAKHA,EAAUI,WAAaL,SAASK,UAChCvB,EAAsBmB,EAAUlB,QAAQ,KAAUD,EAAsBkB,SAASjB,QAAQ,KAIhFuB,EAA4BR,IAGvC,IAAKC,WAAWC,SACd,OAAOF,EAGT,MAAMG,EAAYC,IAAIC,MAAML,EAAKE,SAASI,QAE1C,IAAKH,EACH,OAAOH,EAGT,MACMS,EADuB,IAAIrB,gBAAgBc,SAASjB,QACEyB,IAAI,MAE1DH,SAAEA,EAAQtB,OAAEA,GAAWkB,EACvBQ,EAAe,IAAIvB,gBAAgBH,GAWzC,OAREsB,IAAaL,SAASK,UACtBvB,EAAsBC,GAAQ,KAAUD,EAAsBkB,SAASjB,QAAQ,GAE/E0B,EAAaC,IAAI,IAAKH,GAAkCI,KAExDF,EAAaC,IAAI,IAAKC,KAGjB,GAAGN,KAAYI,EAAab"}

package/dist/esm/index.mjs

@@ -1,2 +1,2 @@
-import{jsx as e,jsxs as n,Fragment as r}from"react/jsx-runtime";import{createContext as t,useRef as o,useState as a,useCallback as i,useEffect as c,use as l}from"react";import{nanoid as s}from"nanoid";const h=t({}),u=({LoadingComponent:t,NextLink:l,OwnLink:s,children:u,loadingTimeout:m=500,pathname:d})=>{const p=o(null),[L,f]=a(!1),g=i(()=>{p.current&&clearTimeout(p.current),p.current=setTimeout(()=>{f(!0)},m)},[m]);return c(()=>{p.current&&clearTimeout(p.current),f(!1),scroll(0,0)},[d]),e(h,{value:{NextLink:l,OwnLink:s,onLinkClicked:()=>{g()}},children:n(r,{children:[u,L?e(t,{}):void 0]})})},m=e=>{if(!globalThis.location)return!1;const n=URL.parse(e,location.origin);if(!n)return!1;const{pathname:r,search:t}=n,o=new URLSearchParams(t);o.has("y")&&o.delete("y");const a=new URLSearchParams(location.search);return a.has("y")&&a.delete("y"),`${r}?${o.toString()}`==`${location.pathname}?${a.toString()}`},d=e=>{if(!globalThis.location)return e;const n=URL.parse(e,location.origin);if(!n)return e;const r=new URLSearchParams(location.search),t=r.get("y");t&&r.delete("y");const{pathname:o,search:a}=n,i=new URLSearchParams(a);return`${o}?${a}`==`${location.pathname}?${r.toString()}`?i.set("y",t??s()):i.set("y",s()),`${o}?${i.toString()}`},p=()=>l(h),L=({children:n,disableRouterCache:r=!0,href:t="#",onClick:o,prefetch:a=!1,scroll:i=!1,...c})=>{const{NextLink:l,OwnLink:s,onLinkClicked:h}=p();return r&&(t=d(t)),e(l,{href:t,legacyBehavior:!0,passHref:!0,prefetch:a,scroll:i,children:e(s,{onClick:e=>{o&&o(e),m(t)||e.defaultPrevented||h()},...c,children:n})})};export{L as Link,h as LinkContext,u as LinkProvider,d as addCacheBusterQueryParam,m as shouldUrlAndLocationMatch,p as useLinkExtra};
+export{LinkContext,LinkProvider}from"./LinkProvider.mjs";export{Link}from"./Link.mjs";export{addCacheBusterQueryParam,shouldUrlAndLocationMatch}from"./helpers.mjs";export{useLinkExtra}from"./useLinkExtra.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../../src/LinkProvider.tsx","../../src/helpers.ts","../../src/useLinkExtra.ts","../../src/Link.tsx"],"sourcesContent":["import type Link from 'next/link.js';\nimport {\n  type ComponentType,\n  type FC,\n  type ReactNode,\n  createContext,\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n} from 'react';\nimport { type LinkContextData, type NextLinkComponent, type OwnLinkProps } from '#types.js';\n\n// Context requires an initial value, but this is set in the provider so casting\n// eslint-disable-next-line @typescript-eslint/consistent-type-assertions\nexport const LinkContext = createContext<LinkContextData>({} as LinkContextData);\n\nexport type LinkProviderProps = {\n  LoadingComponent: ComponentType;\n  NextLink: typeof Link;\n  OwnLink: ComponentType<OwnLinkProps>;\n  children: ReactNode | ReactNode[];\n  loadingTimeout?: number;\n  pathname: string;\n};\n\nexport const LinkProvider: FC<LinkProviderProps> = ({\n  LoadingComponent,\n  NextLink,\n  OwnLink,\n  children,\n  loadingTimeout = 500,\n  pathname,\n}) => {\n  const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const [showLoading, setShowLoading] = useState<boolean>(false);\n\n  const onLinkClicked = useCallback(() => {\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n    }\n\n    timeoutRef.current = setTimeout(() => {\n      setShowLoading(true);\n    }, loadingTimeout);\n  }, [loadingTimeout]);\n\n  useEffect(() => {\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n    }\n\n    // This is setting state based on pathname change\n    // eslint-disable-next-line react-hooks/set-state-in-effect, @eslint-react/set-state-in-effect\n    setShowLoading(false);\n    scroll(0, 0);\n  }, [pathname]);\n\n  return (\n    <LinkContext\n      value={{\n        // Casting due to issues marrying up prop type and context type\n        // eslint-disable-next-line @typescript-eslint/consistent-type-assertions\n        NextLink: NextLink as unknown as NextLinkComponent,\n        OwnLink,\n        onLinkClicked: () => {\n          onLinkClicked();\n        },\n      }}\n    >\n      <>\n        {children}\n        {showLoading ? <LoadingComponent /> : undefined}\n      </>\n    </LinkContext>\n  );\n};\n","import { nanoid } from 'nanoid';\n\nexport const shouldUrlAndLocationMatch = (url: string): boolean => {\n  // It is possible for this to be undefined\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (!globalThis.location) {\n    return false;\n  }\n\n  const parsedUrl = URL.parse(url, location.origin);\n\n  if (!parsedUrl) {\n    return false;\n  }\n\n  const { pathname, search } = parsedUrl;\n  const urlSearchParams = new URLSearchParams(search);\n\n  if (urlSearchParams.has('y')) {\n    urlSearchParams.delete('y');\n  }\n\n  const locationSearchParams = new URLSearchParams(location.search);\n\n  if (locationSearchParams.has('y')) {\n    locationSearchParams.delete('y');\n  }\n\n  return `${pathname}?${urlSearchParams.toString()}` === `${location.pathname}?${locationSearchParams.toString()}`;\n};\n\nexport const addCacheBusterQueryParam = (url: string): string => {\n  // It is possible for this to be undefined\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (!globalThis.location) {\n    return url;\n  }\n\n  const parsedUrl = URL.parse(url, location.origin);\n\n  if (!parsedUrl) {\n    return url;\n  }\n\n  const locationSearchParams = new URLSearchParams(location.search);\n  const locationCacheBusterSearchParam = locationSearchParams.get('y');\n\n  if (locationCacheBusterSearchParam) {\n    locationSearchParams.delete('y');\n  }\n\n  const { pathname, search } = parsedUrl;\n  const searchParams = new URLSearchParams(search);\n\n  if (`${pathname}?${search}` === `${location.pathname}?${locationSearchParams.toString()}`) {\n    searchParams.set('y', locationCacheBusterSearchParam ?? nanoid());\n  } else {\n    searchParams.set('y', nanoid());\n  }\n\n  return `${pathname}?${searchParams.toString()}`;\n};\n","import { use } from 'react';\nimport { type LinkContextData } from '#types.ts';\nimport { LinkContext } from './LinkProvider.tsx';\n\nexport const useLinkExtra = (): LinkContextData => {\n  return use(LinkContext);\n};\n","import { type AnchorHTMLAttributes, type JSX, type ReactNode } from 'react';\nimport { addCacheBusterQueryParam, shouldUrlAndLocationMatch } from '#helpers.ts';\nimport { useLinkExtra } from './useLinkExtra.ts';\n\nexport type LinkProps<T extends object> = {\n  children: ReactNode;\n  disableRouterCache?: boolean;\n  href?: string;\n  prefetch?: boolean;\n  scroll?: boolean;\n} & AnchorHTMLAttributes<HTMLAnchorElement> &\n  T;\n\nexport const Link = <T extends object>({\n  children,\n  disableRouterCache = true,\n  href = '#',\n  onClick,\n  prefetch = false,\n  scroll = false,\n  ...otherProps\n}: LinkProps<T>): JSX.Element => {\n  // This and the two other disables below are false positives\n  // eslint-disable-next-line @eslint-react/static-components\n  const { NextLink, OwnLink, onLinkClicked } = useLinkExtra();\n\n  if (disableRouterCache) {\n    href = addCacheBusterQueryParam(href);\n  }\n\n  return (\n    // This needs to remain: https://github.com/vercel/next.js/discussions/76329\n    // eslint-disable-next-line @typescript-eslint/no-deprecated, @eslint-react/static-components\n    <NextLink href={href} legacyBehavior passHref prefetch={prefetch} scroll={scroll}>\n      <OwnLink // eslint-disable-line @eslint-react/static-components\n        onClick={event => {\n          if (onClick) {\n            onClick(event);\n          }\n\n          if (!shouldUrlAndLocationMatch(href) && !event.defaultPrevented) {\n            onLinkClicked();\n          }\n        }}\n        {...otherProps}\n      >\n        {children}\n      </OwnLink>\n    </NextLink>\n  );\n};\n"],"names":["LinkContext","createContext","LinkProvider","LoadingComponent","NextLink","OwnLink","children","loadingTimeout","pathname","timeoutRef","useRef","showLoading","setShowLoading","useState","onLinkClicked","useCallback","current","clearTimeout","setTimeout","useEffect","scroll","_jsx","value","_jsxs","_Fragment","undefined","shouldUrlAndLocationMatch","url","globalThis","location","parsedUrl","URL","parse","origin","search","urlSearchParams","URLSearchParams","has","delete","locationSearchParams","toString","addCacheBusterQueryParam","locationCacheBusterSearchParam","get","searchParams","set","nanoid","useLinkExtra","use","Link","disableRouterCache","href","onClick","prefetch","otherProps","legacyBehavior","passHref","event","defaultPrevented"],"mappings":"yMAeO,MAAMA,EAAcC,EAA+B,CAAA,GAW7CC,EAAsC,EACjDC,mBACAC,WACAC,UACAC,WACAC,iBAAiB,IACjBC,eAEA,MAAMC,EAAaC,EAA6C,OACzDC,EAAaC,GAAkBC,GAAkB,GAElDC,EAAgBC,EAAY,KAC5BN,EAAWO,SACbC,aAAaR,EAAWO,SAG1BP,EAAWO,QAAUE,WAAW,KAC9BN,GAAe,IACdL,IACF,CAACA,IAaJ,OAXAY,EAAU,KACJV,EAAWO,SACbC,aAAaR,EAAWO,SAK1BJ,GAAe,GACfQ,OAAO,EAAG,IACT,CAACZ,IAGFa,EAACrB,EAAAA,CACCsB,MAAO,CAGLlB,SAAUA,EACVC,UACAS,cAAe,KACbA,eAIJS,EAAAC,EAAA,WACGlB,EACAK,EAAcU,EAAClB,EAAAA,CAAAA,QAAsBsB,QCtEjCC,EAA6BC,IAGxC,IAAKC,WAAWC,SACd,OAAO,EAGT,MAAMC,EAAYC,IAAIC,MAAML,EAAKE,SAASI,QAE1C,IAAKH,EACH,OAAO,EAGT,MAAMtB,SAAEA,EAAQ0B,OAAEA,GAAWJ,EACvBK,EAAkB,IAAIC,gBAAgBF,GAExCC,EAAgBE,IAAI,MACtBF,EAAgBG,OAAO,KAGzB,MAAMC,EAAuB,IAAIH,gBAAgBP,SAASK,QAM1D,OAJIK,EAAqBF,IAAI,MAC3BE,EAAqBD,OAAO,KAGvB,GAAG9B,KAAY2B,EAAgBK,cAAiB,GAAGX,SAASrB,YAAY+B,EAAqBC,cAGzFC,EAA4Bd,IAGvC,IAAKC,WAAWC,SACd,OAAOF,EAGT,MAAMG,EAAYC,IAAIC,MAAML,EAAKE,SAASI,QAE1C,IAAKH,EACH,OAAOH,EAGT,MAAMY,EAAuB,IAAIH,gBAAgBP,SAASK,QACpDQ,EAAiCH,EAAqBI,IAAI,KAE5DD,GACFH,EAAqBD,OAAO,KAG9B,MAAM9B,SAAEA,EAAQ0B,OAAEA,GAAWJ,EACvBc,EAAe,IAAIR,gBAAgBF,GAQzC,MANI,GAAG1B,KAAY0B,KAAa,GAAGL,SAASrB,YAAY+B,EAAqBC,aAC3EI,EAAaC,IAAI,IAAKH,GAAkCI,KAExDF,EAAaC,IAAI,IAAKC,KAGjB,GAAGtC,KAAYoC,EAAaJ,cCxDxBO,EAAe,IACnBC,EAAIhD,GCQAiD,EAAO,EAClB3C,WACA4C,sBAAqB,EACrBC,OAAO,IACPC,UACAC,YAAW,EACXjC,UAAS,KACNkC,MAIH,MAAMlD,SAAEA,EAAQC,QAAEA,EAAOS,cAAEA,GAAkBiC,IAM7C,OAJIG,IACFC,EAAOV,EAAyBU,IAMhC9B,EAACjB,EAAAA,CAAS+C,KAAMA,EAAMI,gBAAc,EAACC,UAAQ,EAACH,SAAUA,EAAUjC,OAAQA,WACxEC,EAAChB,GACC+C,QAASK,IACHL,GACFA,EAAQK,GAGL/B,EAA0ByB,IAAUM,EAAMC,kBAC7C5C,QAGAwC,EAEHhD,SAAAA"}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/useLinkExtra.mjs

@@ -0,0 +1,2 @@
+import{use as r}from"react";import{LinkContext as o}from"./LinkProvider.mjs";const m=()=>r(o);export{m as useLinkExtra};
+//# sourceMappingURL=useLinkExtra.mjs.map

package/dist/esm/useLinkExtra.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLinkExtra.mjs","sources":["../../src/useLinkExtra.ts"],"sourcesContent":["import { use } from 'react';\nimport { type LinkContextData } from '#types.ts';\nimport { LinkContext } from './LinkProvider.tsx';\n\nexport const useLinkExtra = (): LinkContextData => {\n  return use(LinkContext);\n};\n"],"names":["useLinkExtra","use","LinkContext"],"mappings":"mFAIaA,EAAe,IACnBC,EAAIC"}

package/dist/production.analysis.txt

@@ -1,49 +1,49 @@
 -----------------------------
 Rollup File Analysis
 -----------------------------
-bundle size:    4.643 KB
-original size:  5.717 KB
-code reduction: 18.79 %
+bundle size:    5.257 KB
+original size:  6.157 KB
+code reduction: 14.62 %
 module count:   5
 
-██████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
-file:            /src/helpers.ts
-bundle space:    37.43 %
-rendered size:   1.738 KB
-original size:   1.739 KB
-code reduction:  0.06 %
+████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+file:            /src/LinkProvider.tsx
+bundle space:    41.54 %
+rendered size:   2.184 KB
+original size:   2.417 KB
+code reduction:  9.64 %
 dependents:      2
-  - /src/Link.tsx
   - /src/index.ts
+  - /src/useLinkExtra.ts
 
-█████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
-file:            /src/LinkProvider.tsx
-bundle space:    35.21 %
-rendered size:   1.635 KB
-original size:   2.064 KB
-code reduction:  20.78 %
+████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+file:            /src/helpers.ts
+bundle space:    32.97 %
+rendered size:   1.733 KB
+original size:   1.811 KB
+code reduction:  4.31 %
 dependents:      2
-  - /src/useLinkExtra.ts
   - /src/index.ts
+  - /src/Link.tsx
 
-█████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
 file:            /src/Link.tsx
-bundle space:    26.1 %
-rendered size:   1.212 KB
-original size:   1.544 KB
-code reduction:  21.5 %
+bundle space:    24.03 %
+rendered size:   1.263 KB
+original size:   1.559 KB
+code reduction:  18.99 %
 dependents:      1
   - /src/index.ts
 
 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
 file:            /src/useLinkExtra.ts
-bundle space:    1.25 %
-rendered size:   58 Bytes
+bundle space:    1.46 %
+rendered size:   77 Bytes
 original size:   213 Bytes
-code reduction:  72.77 %
+code reduction:  63.85 %
 dependents:      2
-  - /src/Link.tsx
   - /src/index.ts
+  - /src/Link.tsx
 
 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
 file:            /src/index.ts

package/dist/types/cjs/Link.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"Link.d.cts","sourceRoot":"","sources":["../../../src/Link.ctsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI5E,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,GACzC,CAAC,CAAC;AAEJ,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,EAAE,kFAQpC,SAAS,CAAC,CAAC,CAAC,KAAG,GAAG,CAAC,OA6BrB,CAAC"}
+{"version":3,"file":"Link.d.cts","sourceRoot":"","sources":["../../../src/Link.ctsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI5E,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,GACzC,CAAC,CAAC;AAEJ,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,EAAE,kFAQpC,SAAS,CAAC,CAAC,CAAC,KAAG,GAAG,CAAC,OA6BrB,CAAC"}

package/dist/types/cjs/LinkProvider.d.cts

@@ -1,10 +1,9 @@
-import type Link from 'next/link.js';
 import { type ComponentType, type FC, type ReactNode } from 'react';
-import { type LinkContextData, type OwnLinkProps } from '#types.js';
+import { type LinkContextData, type NextLinkComponent, type OwnLinkProps } from '#types.js';
 export declare const LinkContext: import("react").Context<LinkContextData>;
 export type LinkProviderProps = {
     LoadingComponent: ComponentType;
-    NextLink: typeof Link;
+    NextLink: NextLinkComponent;
     OwnLink: ComponentType<OwnLinkProps>;
     children: ReactNode | ReactNode[];
     loadingTimeout?: number;

package/dist/types/cjs/LinkProvider.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"LinkProvider.d.cts","sourceRoot":"","sources":["../../../src/LinkProvider.ctsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,EAAE,EACP,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,KAAK,eAAe,EAA0B,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAI5F,eAAO,MAAM,WAAW,0CAAwD,CAAC;AAEjF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gBAAgB,EAAE,aAAa,CAAC;IAChC,QAAQ,EAAE,OAAO,IAAI,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAkD9C,CAAC"}
+{"version":3,"file":"LinkProvider.d.cts","sourceRoot":"","sources":["../../../src/LinkProvider.ctsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,EAAE,EACP,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAI5F,eAAO,MAAM,WAAW,0CAAwD,CAAC;AAEjF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gBAAgB,EAAE,aAAa,CAAC;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAmE9C,CAAC"}

package/dist/types/cjs/helpers.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.cts","sourceRoot":"","sources":["../../../src/helpers.cts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,OA2BvD,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,KAAK,MAAM,KAAG,MA8BtD,CAAC"}
+{"version":3,"file":"helpers.d.cts","sourceRoot":"","sources":["../../../src/helpers.cts"],"names":[],"mappings":"AAYA,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,OAiBvD,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,KAAK,MAAM,KAAG,MA6BtD,CAAC"}

package/dist/types/esm/Link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../../src/Link.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI5E,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,GACzC,CAAC,CAAC;AAEJ,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,EAAE,kFAQpC,SAAS,CAAC,CAAC,CAAC,KAAG,GAAG,CAAC,OA6BrB,CAAC"}
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../../src/Link.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI5E,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,GACzC,CAAC,CAAC;AAEJ,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,EAAE,kFAQpC,SAAS,CAAC,CAAC,CAAC,KAAG,GAAG,CAAC,OA6BrB,CAAC"}

package/dist/types/esm/LinkProvider.d.ts

@@ -1,10 +1,9 @@
-import type Link from 'next/link.js';
 import { type ComponentType, type FC, type ReactNode } from 'react';
-import { type LinkContextData, type OwnLinkProps } from '#types.js';
+import { type LinkContextData, type NextLinkComponent, type OwnLinkProps } from '#types.js';
 export declare const LinkContext: import("react").Context<LinkContextData>;
 export type LinkProviderProps = {
     LoadingComponent: ComponentType;
-    NextLink: typeof Link;
+    NextLink: NextLinkComponent;
     OwnLink: ComponentType<OwnLinkProps>;
     children: ReactNode | ReactNode[];
     loadingTimeout?: number;

package/dist/types/esm/LinkProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LinkProvider.d.ts","sourceRoot":"","sources":["../../../src/LinkProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,EAAE,EACP,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,KAAK,eAAe,EAA0B,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAI5F,eAAO,MAAM,WAAW,0CAAwD,CAAC;AAEjF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gBAAgB,EAAE,aAAa,CAAC;IAChC,QAAQ,EAAE,OAAO,IAAI,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAkD9C,CAAC"}
+{"version":3,"file":"LinkProvider.d.ts","sourceRoot":"","sources":["../../../src/LinkProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,EAAE,EACP,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAI5F,eAAO,MAAM,WAAW,0CAAwD,CAAC;AAEjF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gBAAgB,EAAE,aAAa,CAAC;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAmE9C,CAAC"}

package/dist/types/esm/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/helpers.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,OA2BvD,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,KAAK,MAAM,KAAG,MA8BtD,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/helpers.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,OAiBvD,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,KAAK,MAAM,KAAG,MA6BtD,CAAC"}