@djangocfg/ui-core 2.1.308 → 2.1.309

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/ui-core",
-  "version": "2.1.308",
+  "version": "2.1.309",
   "description": "Pure React UI component library without Next.js dependencies - for Electron, Vite, CRA apps",
   "keywords": [
     "ui-components",
@@ -91,7 +91,7 @@
     "playground": "playground dev"
   },
   "peerDependencies": {
-    "@djangocfg/i18n": "^2.1.308",
+    "@djangocfg/i18n": "^2.1.309",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
     "moment": "^2.30.1",
@@ -160,9 +160,9 @@
     "vaul": "1.1.2"
   },
   "devDependencies": {
-    "@djangocfg/i18n": "^2.1.308",
+    "@djangocfg/i18n": "^2.1.309",
     "@djangocfg/playground": "workspace:*",
-    "@djangocfg/typescript-config": "^2.1.308",
+    "@djangocfg/typescript-config": "^2.1.309",
     "@types/node": "^24.7.2",
     "@types/react": "^19.1.0",
     "@types/react-dom": "^19.1.0",

package/src/hooks/router/adapters/nextjs.tsx

@@ -32,7 +32,14 @@
  *   never resolved.
  */
 
-import { forwardRef, useMemo, type ReactNode } from 'react';
+import {
+  forwardRef,
+  useMemo,
+  type AnchorHTMLAttributes,
+  type ComponentType,
+  type ReactNode,
+  type Ref,
+} from 'react';
 import { useRouter as useNextRouter } from 'next/navigation';
 import NextLink from 'next/link';
 
@@ -138,3 +145,54 @@ export interface NextLinkProviderProps {
 export function NextLinkProvider({ children }: NextLinkProviderProps) {
   return <LinkProvider value={NextLinkAdapter}>{children}</LinkProvider>;
 }
+
+/**
+ * Minimal shape of the `Link` returned by next-intl's `createNavigation()`.
+ * Typed structurally so we don't take a peer dep on `next-intl`.
+ */
+type NextIntlLinkLike = ComponentType<
+  AnchorHTMLAttributes<HTMLAnchorElement> & {
+    href: string;
+    locale?: string;
+    replace?: boolean;
+    scroll?: boolean;
+    prefetch?: boolean | null;
+    ref?: Ref<HTMLAnchorElement>;
+  }
+>;
+
+/**
+ * Wraps next-intl's `Link` (from `createNavigation()`) into our generic
+ * `LinkComponent`, so apps using `next-intl` get locale-prefixed hrefs on
+ * every `<Link>` rendered through `@djangocfg/ui-core`.
+ *
+ * Pass the result as `baseApp.linkAdapter` to `AppLayout` / `BaseApp` —
+ * it overrides the default `next/link` adapter for the whole subtree.
+ *
+ * @example
+ *   import { createNextIntlLinkAdapter } from '@djangocfg/ui-core/adapters/nextjs';
+ *   import { Link as IntlLink } from '@/i18n/navigation';
+ *
+ *   const linkAdapter = useMemo(() => createNextIntlLinkAdapter(IntlLink), []);
+ *   <AppLayout baseApp={{ ..., linkAdapter }} />
+ */
+export function createNextIntlLinkAdapter(
+  NextIntlLink: NextIntlLinkLike,
+): LinkComponent {
+  return forwardRef<HTMLAnchorElement, LinkComponentProps>(
+    function NextIntlLinkAdapter({ href, replace, scroll, prefetch, children, ...rest }, ref) {
+      return (
+        <NextIntlLink
+          href={href}
+          replace={replace}
+          scroll={scroll}
+          prefetch={prefetch}
+          ref={ref}
+          {...rest}
+        >
+          {children}
+        </NextIntlLink>
+      );
+    },
+  );
+}