@korioinc/next-core 2.0.44 → 2.0.45

package/README.md

@@ -1,99 +1,298 @@
 # @korioinc/next-core
 
-Core utilities and components for Next.js applications.
+Core runtime utilities, providers, and components for Korio Next.js apps.
+
+The package is organized around subpath exports. Most modules depend on
+`@korioinc/next-conf` for app-level configuration, so apps should set up
+`next-kit.config.ts` and wrap `next.config.ts` with `withNextKitConf`.
 
 ## Installation
 
 ```bash
-pnpm add @korioinc/next-core
+pnpm add @korioinc/next-core @korioinc/next-conf
 ```
 
-## Features
+## Requirements
+
+- Next.js `>=16.2.6`
+- React and React DOM `>=19.2.4`
+- Tailwind CSS `>=4.0.0`
+- `@lingui/core` and `@lingui/react` `>=6.0.1`
+- `@headlessui/react` `>=2.2.0`
+
+## Required app setup
+
+Create `next-kit.config.ts`:
 
-- **Authentication**: Complete auth system with JWT support
-- **Internationalization**: i18n routing and locale management
-- **Components**: Reusable UI components (Theme switcher, Locale switcher)
-- **Ads Management**: Ad container components and configurations
-- **API Client**: Configured fetch client with interceptors
-- **Navigation**: Type-safe navigation system
-- **Local Storage**: Enhanced local storage management
-- **Utilities**: Common utility functions
+```typescript
+import type { NextCoreConfig } from '@korioinc/next-conf';
+
+const config: NextCoreConfig = {
+  api: {
+    baseUrl: process.env.API_BASE_URL,
+    timeout: 5000,
+    headers: {},
+  },
+  cookie: {
+    accessTokenName: '_at',
+    domain: '.localhost',
+    maxAge: 7 * 24 * 60 * 60,
+  },
+  auth: {
+    restrictedPaths: ['/accounts/login', '/accounts/register'],
+    requiredPaths: ['/accounts/profile', '/accounts/settings'],
+    loginUrl: '/accounts/login',
+    homeUrl: '/',
+  },
+  analytics: {
+    gaId: process.env.NEXT_PUBLIC_GA_ID,
+    gtmId: process.env.NEXT_PUBLIC_GTM_ID,
+    adsensePublisherId: process.env.NEXT_PUBLIC_ADSENSE_PUBLISHER_ID,
+  },
+};
 
-## Usage
+export default config;
+```
 
-### Authentication
+Wrap `next.config.ts`:
 
 ```typescript
+import type { NextConfig } from 'next';
+
+import { withNextKitConf } from '@korioinc/next-conf/plugin';
+
+const nextConfig: NextConfig = {
+  turbopack: {
+    rules: {
+      '*.po': {
+        loaders: ['@lingui/loader'],
+        as: '*.js',
+      },
+    },
+  },
+};
+
+export default withNextKitConf(nextConfig);
+```
+
+`withNextKitConf` exposes the app config, `lingui.config`, and the generated
+Lingui loader to this package.
+
+## Public entrypoints
+
+| Entrypoint                          | Main exports                                                                               |
+| ----------------------------------- | ------------------------------------------------------------------------------------------ |
+| `@korioinc/next-core/ads`           | `GoogleAdSense`, `AdContainer`, `MockAdDisplay`, ad types and config                       |
+| `@korioinc/next-core/auth`          | Server auth helpers, routing helper, client provider, permission utilities, auth types     |
+| `@korioinc/next-core/auth/server`   | `getAuthData`, `getCurrentUser`, `isAuthenticated`, permission checks, `handleAuthRouting` |
+| `@korioinc/next-core/auth/client`   | `AuthContextProvider`, `useAuthContext`, client token and permission helpers               |
+| `@korioinc/next-core/navigation`    | Navigation types, permission filtering, `NavigationBuilder`                                |
+| `@korioinc/next-core/api-client`    | `requestApi`, `ApiResponse`                                                                |
+| `@korioinc/next-core/i18n/*`        | Routing, Lingui setup, Lingui initialization, client provider                              |
+| `@korioinc/next-core/utils`         | `cn`, `isBrowser`, `getBaseUrl`, sitemap helpers                                           |
+| `@korioinc/next-core/local-storage` | `LocalStorageManager`, `createStorageInstance`, `storage`, Valtio persistence helpers      |
+| `@korioinc/next-core/components`    | `LocaleSwitcher`, `ThemeSwitcher`, `Tooltip`, `HeadManifest`, `JsonLd`                     |
+| `@korioinc/next-core/theme`         | Client `ThemeProvider`, `useTheme`, theme types                                            |
+| `@korioinc/next-core/theme/server`  | Server `ThemeProvider`, theme types                                                        |
+| `@korioinc/next-core/styles/*`      | Built CSS assets, including `styles/globals.css`                                           |
+| `@korioinc/next-core/types/*`       | Published ambient type files                                                               |
+
+## Authentication
+
+Server helpers read the access token cookie configured in `next-kit.config.ts`
+and cache auth data per React request.
+
+```tsx
+import type { ReactNode } from 'react';
+
+import { AuthContextProvider } from '@korioinc/next-core/auth/client';
+import { getAuthData } from '@korioinc/next-core/auth/server';
+
+export default async function Layout({ children }: { children: ReactNode }) {
+  const authData = await getAuthData();
+
+  return <AuthContextProvider initialAuthData={authData}>{children}</AuthContextProvider>;
+}
+```
+
+Client components can read auth state and permission helpers from the provider:
+
+```tsx
+'use client';
+
 import { useAuthContext } from '@korioinc/next-core/auth/client';
-import { getCurrentUser } from '@korioinc/next-core/auth/server';
 
-// Client-side
-const { isLogin, user, login, logout } = useAuthContext();
+export function AccountButton() {
+  const { isLogin, user, hasPermission, logout } = useAuthContext();
+
+  if (!isLogin) return null;
 
-// Server-side
-const user = await getCurrentUser();
+  return (
+    <button disabled={!hasPermission('update')} onClick={logout}>
+      {user?.name}
+    </button>
+  );
+}
 ```
 
-### Internationalization
+## Routing and i18n
+
+Use auth and locale routing together from the Next.js request entrypoint:
 
 ```typescript
+import type { NextFetchEvent, NextRequest } from 'next/server';
+import { NextResponse } from 'next/server';
+
+import { handleAuthRouting } from '@korioinc/next-core/auth/server';
 import { handleLocaleRouting } from '@korioinc/next-core/i18n/routing';
 
-// In middleware.ts
-export default function middleware(request: NextRequest) {
+export default async function proxy(request: NextRequest, _event: NextFetchEvent): Promise<NextResponse> {
+  const authResponse = await handleAuthRouting(request);
+  if (authResponse) return authResponse;
+
   return handleLocaleRouting(request);
 }
 ```
 
-### Components
+Server components can initialize Lingui and pass loaded messages to the client:
 
-```typescript
-import { ThemeSwitcher, LocaleSwitcher } from '@korioinc/next-core/components';
-import { ThemeProvider } from '@korioinc/next-core/theme/server';
+```tsx
+import type { PropsWithChildren } from 'react';
+
+import { PageLocaleParam, initLingui } from '@korioinc/next-core/i18n/init-lingui';
+import { allMessages } from '@korioinc/next-core/i18n/lingui.setup';
+import { LinguiClientProvider } from '@korioinc/next-core/i18n/providers/lingui-client-provider';
+
+export default async function LocaleLayout({ children, params }: PropsWithChildren<PageLocaleParam>) {
+  const locale = (await params).locale;
+  initLingui(locale);
 
-export function Layout({ children }: { children: React.ReactNode }) {
   return (
-    <ThemeProvider attribute="class" enableSystem defaultTheme="system">
+    <LinguiClientProvider initialLocale={locale} initialMessages={allMessages[locale] ?? {}}>
       {children}
-    </ThemeProvider>
+    </LinguiClientProvider>
   );
 }
+```
 
-export function Header() {
+Useful routing exports include `getLocales`, `getDefaultLocale`,
+`getPathname`, `getCurrentPathname`, `getCurrentLanguageAlternates`,
+`getFullUrl`, and `getFullUrlByPathname`. Client components can use
+`useToLocalePath` from `@korioinc/next-core/i18n/routing.client`.
+
+## Theme and components
+
+Use the server theme provider in layouts when theme state may be read from
+cookies:
+
+```tsx
+import type { ReactNode } from 'react';
+
+import { LocaleSwitcher, ThemeSwitcher } from '@korioinc/next-core/components';
+import { ThemeProvider } from '@korioinc/next-core/theme/server';
+
+export default function Layout({ children }: { children: ReactNode }) {
   return (
-    <header>
-      <ThemeSwitcher />
-      <LocaleSwitcher />
-    </header>
+    <ThemeProvider attribute='class' enableSystem defaultTheme='system'>
+      <header>
+        <ThemeSwitcher />
+        <LocaleSwitcher />
+      </header>
+      {children}
+    </ThemeProvider>
   );
 }
 ```
 
-### Ads
+Import the shared styles from app CSS:
+
+```css
+@import '@korioinc/next-core/styles/globals.css';
+```
+
+## API client
+
+`requestApi` is a server-side fetch helper. It uses `api.baseUrl` and the access
+token cookie from `next-kit.config.ts`, forwards the token as `Authorization`,
+updates the cookie from an `x-refreshed-token` response header, and clears the
+cookie on `401`.
 
 ```typescript
-import { AdContainer } from '@korioinc/next-core/ads';
+import { requestApi } from '@korioinc/next-core/api-client';
+
+type SearchResult = {
+  id: string;
+  title: string;
+};
+
+const results = await requestApi<SearchResult[]>('/search', {
+  params: { q: 'korio' },
+  next: { revalidate: 60 },
+});
+```
+
+## Ads
+
+```tsx
+import type { ReactNode } from 'react';
+
+import { getConfig } from '@korioinc/next-conf';
+import { AdContainer, GoogleAdSense } from '@korioinc/next-core/ads';
+
+export function RootProviders({ children }: { children: ReactNode }) {
+  const publisherId = getConfig().analytics?.adsensePublisherId;
 
-export function Page() {
   return (
-    <AdContainer
-      adType="leaderboard"
-      className="my-4"
-    />
+    <>
+      {publisherId && <GoogleAdSense publisherId={publisherId} />}
+      {children}
+    </>
   );
 }
+
+export function PageAd() {
+  return <AdContainer adType='leaderboard' className='hidden lg:block' />;
+}
 ```
 
-## Requirements
+`GoogleAdSense` requires a `publisherId` prop. `AdContainer` reads
+`analytics.adsensePublisherId` from `next-kit.config.ts` when loading production
+ads and renders mock ads for local or development environments. See
+`src/ads/README.md` in this package for available ad types and placement patterns.
 
-- Next.js 15+
-- React 19+
-- TypeScript 5.9+
+## Local storage
 
-## License
+```typescript
+import { LocalStorageManager, createPersistedStore } from '@korioinc/next-core/local-storage';
 
-MIT
+type Preferences = {
+  compact: boolean;
+};
+
+const preferences = new LocalStorageManager<Preferences>('preferences');
+await preferences.setItem({ compact: true });
 
-## Contributing
+const store = createPersistedStore('todo-store', {
+  todos: [] as string[],
+});
+
+await store.hydrate();
+```
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+`LocalStorageManager` uses localforage and reads `storage.name`,
+`storage.storeName`, and `storage.driver` from `next-kit.config.ts`.
+
+## Utilities
+
+```typescript
+import { cn, getBaseUrl, getEntry, getUrl, isBrowser } from '@korioinc/next-core/utils';
+```
+
+- `cn` combines `clsx` and `tailwind-merge`
+- `getBaseUrl` uses the app URL environment fallback logic
+- `getEntry` and `getUrl` help build sitemap entries
+- `isBrowser` guards browser-only code paths
+
+## License
+
+MIT

package/dist/i18n/routing.d.ts

@@ -8,6 +8,7 @@ export declare function getLocales(): string[];
  * Get default locale
  */
 export declare function getDefaultLocale(): string;
+export declare function getHreflang(locale: string): string;
 export declare function getPathLocale(pathname: string): string | undefined;
 export declare function handleLocaleRouting(request: NextRequest): NextResponse<unknown>;
 export declare function getRequestLocale(requestHeaders: Headers): string;

package/dist/i18n/routing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/i18n/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoC7D;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAErC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AA4BD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAiFD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,yBA2EvD;AAED,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,CAShE;AAED,wBAAgB,eAAe,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW9F;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAevG;AAED,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,UAY7E;AAsBD,wBAAgB,qBAAqB,CAAC,QAAQ,GAAE,MAAY,0BAwB3D;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAK1D;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAKxE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAuBpF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE3E;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKrE;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,eAAe,CAAC,CAMvE;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAU1D;AAED,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAIpF;AAED,KAAK,aAAa,GACd,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAC7C,eAAe,GACf,uBAAuB,GACvB,SAAS,CAAC;AAiDd,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAErF;AAED,wBAAsB,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAIxE;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,MAAM,CAAC,CAKnE"}
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/i18n/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoC7D;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAErC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIlD;AA4BD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAiFD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,yBA2EvD;AAED,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,CAShE;AAED,wBAAgB,eAAe,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW9F;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAevG;AAED,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,UAY7E;AAsBD,wBAAgB,qBAAqB,CAAC,QAAQ,GAAE,MAAY,0BA0B3D;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAK1D;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAKxE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAuBpF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE3E;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKrE;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,eAAe,CAAC,CAMvE;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAU1D;AAED,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAIpF;AAED,KAAK,aAAa,GACd,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAC7C,eAAe,GACf,uBAAuB,GACvB,SAAS,CAAC;AAiDd,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAErF;AAED,wBAAsB,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAIxE;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,MAAM,CAAC,CAKnE"}

package/dist/i18n/routing.js

@@ -36,6 +36,10 @@ export function getLocales() {
 export function getDefaultLocale() {
     return DEFAULT_FALLBACK();
 }
+export function getHreflang(locale) {
+    const [language, region] = locale.split('-');
+    return region ? `${language.toLowerCase()}-${region.toUpperCase()}` : language.toLowerCase();
+}
 /**
  * 쿠키를 설정하는 헬퍼 함수
  */
@@ -245,11 +249,12 @@ export function getLanguageAlternates(pathname = '/') {
     locales
         .filter((locale) => locale !== 'pseudo')
         .forEach((locale) => {
+        const hreflang = getHreflang(locale);
         if (LOCALE_PREFIX === 'as-needed' && locale === defaultFallback) {
-            alternates[locale] = basePath;
+            alternates[hreflang] = basePath;
         }
         else {
-            alternates[locale] = `/${locale}${basePath === '/' ? '' : basePath}`;
+            alternates[hreflang] = `/${locale}${basePath === '/' ? '' : basePath}`;
         }
     });
     return alternates;

package/dist/utils/index.d.ts

@@ -1,3 +1,3 @@
 export { cn, isBrowser, getBaseUrl } from './helpers';
-export { getEntry, getUrl } from './sitemap';
+export { getEntry, getLocalizedEntries, getUrl } from './sitemap';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC"}

package/dist/utils/index.js

@@ -1,2 +1,2 @@
 export { cn, isBrowser, getBaseUrl } from './helpers';
-export { getEntry, getUrl } from './sitemap';
+export { getEntry, getLocalizedEntries, getUrl } from './sitemap';

package/dist/utils/sitemap.d.ts

@@ -1,3 +1,4 @@
+import type { MetadataRoute } from 'next';
 import { getPathname } from '../i18n/routing';
 type Href = Parameters<typeof getPathname>[0]['href'];
 export declare function getEntry(href: Href, options?: Record<string, string>): {
@@ -8,6 +9,7 @@ export declare function getEntry(href: Href, options?: Record<string, string>):
         };
     };
 };
+export declare function getLocalizedEntries(routes: readonly Href[]): MetadataRoute.Sitemap;
 export declare function getUrl(href: Href, locale: string): string;
 export {};
 //# sourceMappingURL=sitemap.d.ts.map

package/dist/utils/sitemap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/utils/sitemap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQjD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;;;;;;;EAUxE;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,UAKhD"}
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/utils/sitemap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,EAAe,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgB9D,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;;;;;;;EAQxE;AAMD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,GAAG,aAAa,CAAC,OAAO,CAWlF;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,UAKhD"}

package/dist/utils/sitemap.js

@@ -1,17 +1,40 @@
-import { getPathname } from '../i18n/routing';
+import { getHreflang, getPathname } from '../i18n/routing';
 import { getBaseUrl } from '../utils/helpers';
 import linguiConfig from 'lingui.config';
 const { locales, fallbackLocales } = linguiConfig;
 const defaultLocale = fallbackLocales.default;
+const indexableLocales = [...locales]
+    .filter((locale) => locale !== 'pseudo')
+    .sort((a, b) => {
+    if (a === defaultLocale)
+        return -1;
+    if (b === defaultLocale)
+        return 1;
+    return a.localeCompare(b);
+});
 export function getEntry(href, options = {}) {
     return {
         url: getUrl(href, defaultLocale),
         alternates: {
-            languages: Object.fromEntries(locales.filter((locale) => locale !== 'pseudo').map((cur) => [cur, getUrl(href, cur)])),
+            languages: Object.fromEntries(indexableLocales.map((cur) => [getHreflang(cur), getUrl(href, cur)])),
         },
         ...options,
     };
 }
+function getAlternateLanguages(href) {
+    return Object.fromEntries(indexableLocales.map((locale) => [getHreflang(locale), getUrl(href, locale)]));
+}
+export function getLocalizedEntries(routes) {
+    return routes.flatMap((href) => {
+        const languages = getAlternateLanguages(href);
+        return indexableLocales.map((locale) => ({
+            url: getUrl(href, locale),
+            alternates: {
+                languages,
+            },
+        }));
+    });
+}
 export function getUrl(href, locale) {
     const pathname = getPathname({ locale, href });
     const host = getBaseUrl();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@korioinc/next-core",
-  "version": "2.0.44",
+  "version": "2.0.45",
   "type": "module",
   "exports": {
     "./ads": {
@@ -78,10 +78,10 @@
     "@lingui/react": "^6.0.1",
     "@tailwindcss/typography": "^0.5.19",
     "@types/negotiator": "^0.6.4",
-    "@types/node": "^25.6.2",
+    "@types/node": "^25.8.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "eslint": "^10.3.0",
+    "eslint": "^10.4.0",
     "jsdom": "^29.1.1",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
@@ -89,12 +89,12 @@
     "tsc-alias": "^1.8.17",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5",
-    "@korioinc/next-configs": "2.0.44"
+    "vitest": "^4.1.6",
+    "@korioinc/next-configs": "2.0.45"
   },
   "dependencies": {
     "@floating-ui/react": "^0.27.19",
-    "@formatjs/intl-localematcher": "^0.8.6",
+    "@formatjs/intl-localematcher": "^0.8.8",
     "clsx": "^2.1.1",
     "cookies-next": "^6.1.1",
     "cosmiconfig": "^9.0.1",
@@ -103,9 +103,9 @@
     "negotiator": "^1.0.0",
     "pretendard": "^1.3.9",
     "schema-dts": "^2.0.0",
-    "tailwind-merge": "^3.5.0",
+    "tailwind-merge": "^3.6.0",
     "valtio": "^2.3.2",
-    "@korioinc/next-conf": "2.0.44"
+    "@korioinc/next-conf": "2.0.45"
   },
   "publishConfig": {
     "access": "public",