intor 2.2.4 → 2.2.6

package/dist/next/index.d.cts

@@ -1,11 +1,91 @@
-import { Level, NormalizerConfig, FormatterConfig, LoggerPreset } from 'logry/edge';
-import { Locale, LocaleMessages, FallbackLocalesMap, TranslateHandlers, ScopedLeafKeys, LocalizedLeafKeys, Replacement, LocalizedNodeKeys } from 'intor-translator';
-import * as React from 'react';
+import { LocaleMessages, Locale, FallbackLocalesMap, TranslateHandlers, ScopedLeafKeys, LocalizedLeafKeys, Replacement, LocalizedNodeKeys } from 'intor-translator';
 import { Url } from 'next/dist/shared/lib/router/router';
 import { LinkProps as LinkProps$1 } from 'next/link';
+import * as React from 'react';
 import * as next_dist_shared_lib_app_router_context_shared_runtime from 'next/dist/shared/lib/app-router-context.shared-runtime';
 import { NavigateOptions } from 'next/dist/shared/lib/app-router-context.shared-runtime';
+import { Level, NormalizerConfig, FormatterConfig, LoggerPreset } from 'logry/edge';
 import { RedirectType } from 'next/navigation';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare const PREFIX_PLACEHOLDER = "{locale}";
+
+/**
+ * Conditional type for generated types.
+ * - Returns `Then` if `IntorGeneratedTypes` exists, otherwise `Else`.
+ */
+type IfGen<Then, Else = never> = IntorGeneratedTypes extends void ? Else : Then;
+/**
+ * Union of all configuration keys.
+ * - Defaults to `string` if `IntorGeneratedTypes` does not exist.
+ */
+type GenConfigKeys = IfGen<keyof IntorGeneratedTypes, string>;
+/**
+ * Configuration shape for a given config key.
+ * - If `IntorGeneratedTypes` is not defined, falls back to default shape.
+ * Otherwise, picks `Locales` and `Messages` according to the key.
+ */
+type GenConfig<CK extends GenConfigKeys = "__default__"> = IntorGeneratedTypes extends void ? {
+    Locales: string;
+    Messages: LocaleMessages;
+} : CK extends keyof IntorGeneratedTypes ? {
+    Locales: IntorGeneratedTypes[CK]["Locales"];
+    Messages: {
+        [K in IntorGeneratedTypes[CK]["Locales"]]: IntorGeneratedTypes[CK]["Messages"][typeof PREFIX_PLACEHOLDER];
+    };
+} : never;
+/** Extracts messages for a given config key */
+type GenMessages<CK extends GenConfigKeys = "__default__"> = GenConfig<CK>["Messages"];
+/** Extracts locales for a given config key */
+type GenLocale<CK extends GenConfigKeys = "__default__"> = GenConfig<CK>["Locales"];
+
+interface LinkProps extends Omit<LinkProps$1, "href">, Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+    href?: Url;
+    locale?: GenLocale;
+}
+/**
+ * Localized Link component
+ *
+ * - Wraps Next.js Link and handles locale switching.
+ * - Full reload occurs only if the locale changes and requires it; otherwise updates context.
+ */
+declare const Link: ({ href, locale, children, onClick, ...props }: LinkProps) => React.JSX.Element;
+
+/**
+ * Custom hook to get the current pathname in different forms based on the active locale.
+ *
+ * This hook wraps Next.js `usePathname` and processes the pathname according to the app's
+ * locale configuration.
+ *
+ * @example
+ * const { localizedPathname, standardizedPathname, unprefixedPathname } = usePathname();
+ * console.log(localizedPathname); // e.g. "/en/about"
+ * console.log(standardizedPathname); // e.g. "/{locale}/about"
+ * console.log(unprefixedPathname); // e.g. "/about"
+ */
+declare const usePathname: () => {
+    localizedPathname: string;
+    standardizedPathname: string;
+    unprefixedPathname: string;
+};
+
+/**
+ * useRouter hook.
+ *
+ * Wraps Next.js useRouter and provides push/replace methods that automatically switch locale.
+ */
+declare const useRouter: () => {
+    back(): void;
+    forward(): void;
+    refresh(): void;
+    prefetch(href: string, options?: next_dist_shared_lib_app_router_context_shared_runtime.PrefetchOptions): void;
+    push: (href: string, options?: NavigateOptions & {
+        locale?: GenLocale;
+    }) => void;
+    replace: (href: string, options?: NavigateOptions & {
+        locale?: Locale;
+    }) => void;
+};
 
 type CookieRawOptions = {
     /** Completely disable cookie usage (no read, no write, no lookup by name) - default: false */
@@ -125,55 +205,38 @@ type IntorResolvedConfig = (WithLoader | WithoutLoader) & {
     readonly cache: CacheResolvedOptions;
 };
 
+/**
+ * redirect utility.
+ *
+ * - Wraps Next.js redirect and applies locale-aware navigation.
+ * - Automatically prefixes the pathname with the correct locale.
+ * - External URLs are redirected directly without modification.
+ */
+declare const redirect: ({ config, locale, url, type, }: {
+    config: IntorResolvedConfig;
+    locale?: GenLocale;
+    url: string;
+    type?: RedirectType | undefined;
+}) => Promise<never>;
+
 interface IntorProviderProps {
     value: {
         config: IntorResolvedConfig;
         initialLocale: Locale;
-        pathname: string;
-        messages: Readonly<LocaleMessages>;
+        pathname?: string;
+        messages?: Readonly<LocaleMessages>;
     };
     children: React.ReactNode;
 }
 
-declare const IntorProvider: ({ value: { config, pathname, initialLocale, messages }, children, }: IntorProviderProps) => React.JSX.Element;
+declare const IntorProvider: ({ value: { config, pathname, initialLocale, messages }, children, }: IntorProviderProps) => react_jsx_runtime.JSX.Element;
 
 type TranslateHandlersProviderProps = {
     children: React.ReactNode;
     handlers: TranslateHandlers;
 };
 
-declare const TranslateHandlersProvider: ({ children, handlers, }: TranslateHandlersProviderProps) => React.JSX.Element;
-
-declare const PREFIX_PLACEHOLDER = "{locale}";
-
-/**
- * Conditional type for generated types.
- * - Returns `Then` if `IntorGeneratedTypes` exists, otherwise `Else`.
- */
-type IfGen<Then, Else = never> = IntorGeneratedTypes extends void ? Else : Then;
-/**
- * Union of all configuration keys.
- * - Defaults to `string` if `IntorGeneratedTypes` does not exist.
- */
-type GenConfigKeys = IfGen<keyof IntorGeneratedTypes, string>;
-/**
- * Configuration shape for a given config key.
- * - If `IntorGeneratedTypes` is not defined, falls back to default shape.
- * Otherwise, picks `Locales` and `Messages` according to the key.
- */
-type GenConfig<CK extends GenConfigKeys = "__default__"> = IntorGeneratedTypes extends void ? {
-    Locales: string;
-    Messages: LocaleMessages;
-} : CK extends keyof IntorGeneratedTypes ? {
-    Locales: IntorGeneratedTypes[CK]["Locales"];
-    Messages: {
-        [K in IntorGeneratedTypes[CK]["Locales"]]: IntorGeneratedTypes[CK]["Messages"][typeof PREFIX_PLACEHOLDER];
-    };
-} : never;
-/** Extracts messages for a given config key */
-type GenMessages<CK extends GenConfigKeys = "__default__"> = GenConfig<CK>["Messages"];
-/** Extracts locales for a given config key */
-type GenLocale<CK extends GenConfigKeys = "__default__"> = GenConfig<CK>["Locales"];
+declare const TranslateHandlersProvider: ({ children, handlers, }: TranslateHandlersProviderProps) => react_jsx_runtime.JSX.Element;
 
 /** Base properties shared by all translator instances. */
 interface TranslatorBaseProps<M = unknown> {
@@ -216,57 +279,4 @@ type TranslatorInstance<M, PK extends string | undefined = undefined> = {
 declare function useTranslator<CK extends GenConfigKeys = "__default__">(): TranslatorInstance<GenMessages<CK>>;
 declare function useTranslator<CK extends GenConfigKeys = "__default__", PK extends string = LocalizedNodeKeys<GenMessages<CK>>>(preKey: IfGen<PK, string>): TranslatorInstance<GenMessages<CK>, PK>;
 
-interface LinkProps extends Omit<LinkProps$1, "href">, Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
-    href?: Url;
-    locale?: GenLocale;
-}
-/**
- * Localized Link component
- *
- * - Wraps Next.js Link and handles locale switching.
- * - Full reload occurs only if the locale changes and requires it; otherwise updates context.
- */
-declare const Link: ({ href, locale, children, onClick, ...props }: LinkProps) => React.JSX.Element;
-
-/**
- * usePathname hook
- *
- * Wraps Next.js usePathname and returns the current pathname prefixed with the active locale.
- */
-declare const usePathname: () => string;
-
-/**
- * useRouter hook.
- *
- * Wraps Next.js useRouter and provides push/replace methods that automatically switch locale.
- */
-declare const useRouter: () => {
-    back(): void;
-    forward(): void;
-    refresh(): void;
-    prefetch(href: string, options?: next_dist_shared_lib_app_router_context_shared_runtime.PrefetchOptions): void;
-    push: (href: string, options?: NavigateOptions & {
-        locale?: GenLocale;
-    }) => void;
-    replace: (href: string, options?: NavigateOptions & {
-        locale?: Locale;
-    }) => void;
-};
-
-/**
- * redirect utility.
- *
- * - Wraps Next.js redirect and applies locale-aware navigation.
- * - Automatically prefixes the pathname with the correct locale.
- * - External URLs are redirected directly without modification.
- */
-declare const redirect: ({ config, locale, url, type, }: {
-    config: IntorResolvedConfig;
-    locale?: GenLocale;
-    url: string;
-    type?: RedirectType | undefined;
-}) => Promise<never>;
-
-declare const PATHNAME_HEADER_NAME = "x-intor-pathname";
-
-export { IntorProvider, type IntorProviderProps, Link, PATHNAME_HEADER_NAME, TranslateHandlersProvider, type TranslateHandlersProviderProps, redirect, usePathname, useRouter, useTranslator };
+export { IntorProvider, type IntorProviderProps, Link, TranslateHandlersProvider, type TranslateHandlersProviderProps, redirect, usePathname, useRouter, useTranslator };

package/dist/next/index.d.ts

@@ -1,11 +1,91 @@
-import { Level, NormalizerConfig, FormatterConfig, LoggerPreset } from 'logry/edge';
-import { Locale, LocaleMessages, FallbackLocalesMap, TranslateHandlers, ScopedLeafKeys, LocalizedLeafKeys, Replacement, LocalizedNodeKeys } from 'intor-translator';
-import * as React from 'react';
+import { LocaleMessages, Locale, FallbackLocalesMap, TranslateHandlers, ScopedLeafKeys, LocalizedLeafKeys, Replacement, LocalizedNodeKeys } from 'intor-translator';
 import { Url } from 'next/dist/shared/lib/router/router';
 import { LinkProps as LinkProps$1 } from 'next/link';
+import * as React from 'react';
 import * as next_dist_shared_lib_app_router_context_shared_runtime from 'next/dist/shared/lib/app-router-context.shared-runtime';
 import { NavigateOptions } from 'next/dist/shared/lib/app-router-context.shared-runtime';
+import { Level, NormalizerConfig, FormatterConfig, LoggerPreset } from 'logry/edge';
 import { RedirectType } from 'next/navigation';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare const PREFIX_PLACEHOLDER = "{locale}";
+
+/**
+ * Conditional type for generated types.
+ * - Returns `Then` if `IntorGeneratedTypes` exists, otherwise `Else`.
+ */
+type IfGen<Then, Else = never> = IntorGeneratedTypes extends void ? Else : Then;
+/**
+ * Union of all configuration keys.
+ * - Defaults to `string` if `IntorGeneratedTypes` does not exist.
+ */
+type GenConfigKeys = IfGen<keyof IntorGeneratedTypes, string>;
+/**
+ * Configuration shape for a given config key.
+ * - If `IntorGeneratedTypes` is not defined, falls back to default shape.
+ * Otherwise, picks `Locales` and `Messages` according to the key.
+ */
+type GenConfig<CK extends GenConfigKeys = "__default__"> = IntorGeneratedTypes extends void ? {
+    Locales: string;
+    Messages: LocaleMessages;
+} : CK extends keyof IntorGeneratedTypes ? {
+    Locales: IntorGeneratedTypes[CK]["Locales"];
+    Messages: {
+        [K in IntorGeneratedTypes[CK]["Locales"]]: IntorGeneratedTypes[CK]["Messages"][typeof PREFIX_PLACEHOLDER];
+    };
+} : never;
+/** Extracts messages for a given config key */
+type GenMessages<CK extends GenConfigKeys = "__default__"> = GenConfig<CK>["Messages"];
+/** Extracts locales for a given config key */
+type GenLocale<CK extends GenConfigKeys = "__default__"> = GenConfig<CK>["Locales"];
+
+interface LinkProps extends Omit<LinkProps$1, "href">, Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+    href?: Url;
+    locale?: GenLocale;
+}
+/**
+ * Localized Link component
+ *
+ * - Wraps Next.js Link and handles locale switching.
+ * - Full reload occurs only if the locale changes and requires it; otherwise updates context.
+ */
+declare const Link: ({ href, locale, children, onClick, ...props }: LinkProps) => React.JSX.Element;
+
+/**
+ * Custom hook to get the current pathname in different forms based on the active locale.
+ *
+ * This hook wraps Next.js `usePathname` and processes the pathname according to the app's
+ * locale configuration.
+ *
+ * @example
+ * const { localizedPathname, standardizedPathname, unprefixedPathname } = usePathname();
+ * console.log(localizedPathname); // e.g. "/en/about"
+ * console.log(standardizedPathname); // e.g. "/{locale}/about"
+ * console.log(unprefixedPathname); // e.g. "/about"
+ */
+declare const usePathname: () => {
+    localizedPathname: string;
+    standardizedPathname: string;
+    unprefixedPathname: string;
+};
+
+/**
+ * useRouter hook.
+ *
+ * Wraps Next.js useRouter and provides push/replace methods that automatically switch locale.
+ */
+declare const useRouter: () => {
+    back(): void;
+    forward(): void;
+    refresh(): void;
+    prefetch(href: string, options?: next_dist_shared_lib_app_router_context_shared_runtime.PrefetchOptions): void;
+    push: (href: string, options?: NavigateOptions & {
+        locale?: GenLocale;
+    }) => void;
+    replace: (href: string, options?: NavigateOptions & {
+        locale?: Locale;
+    }) => void;
+};
 
 type CookieRawOptions = {
     /** Completely disable cookie usage (no read, no write, no lookup by name) - default: false */
@@ -125,55 +205,38 @@ type IntorResolvedConfig = (WithLoader | WithoutLoader) & {
     readonly cache: CacheResolvedOptions;
 };
 
+/**
+ * redirect utility.
+ *
+ * - Wraps Next.js redirect and applies locale-aware navigation.
+ * - Automatically prefixes the pathname with the correct locale.
+ * - External URLs are redirected directly without modification.
+ */
+declare const redirect: ({ config, locale, url, type, }: {
+    config: IntorResolvedConfig;
+    locale?: GenLocale;
+    url: string;
+    type?: RedirectType | undefined;
+}) => Promise<never>;
+
 interface IntorProviderProps {
     value: {
         config: IntorResolvedConfig;
         initialLocale: Locale;
-        pathname: string;
-        messages: Readonly<LocaleMessages>;
+        pathname?: string;
+        messages?: Readonly<LocaleMessages>;
     };
     children: React.ReactNode;
 }
 
-declare const IntorProvider: ({ value: { config, pathname, initialLocale, messages }, children, }: IntorProviderProps) => React.JSX.Element;
+declare const IntorProvider: ({ value: { config, pathname, initialLocale, messages }, children, }: IntorProviderProps) => react_jsx_runtime.JSX.Element;
 
 type TranslateHandlersProviderProps = {
     children: React.ReactNode;
     handlers: TranslateHandlers;
 };
 
-declare const TranslateHandlersProvider: ({ children, handlers, }: TranslateHandlersProviderProps) => React.JSX.Element;
-
-declare const PREFIX_PLACEHOLDER = "{locale}";
-
-/**
- * Conditional type for generated types.
- * - Returns `Then` if `IntorGeneratedTypes` exists, otherwise `Else`.
- */
-type IfGen<Then, Else = never> = IntorGeneratedTypes extends void ? Else : Then;
-/**
- * Union of all configuration keys.
- * - Defaults to `string` if `IntorGeneratedTypes` does not exist.
- */
-type GenConfigKeys = IfGen<keyof IntorGeneratedTypes, string>;
-/**
- * Configuration shape for a given config key.
- * - If `IntorGeneratedTypes` is not defined, falls back to default shape.
- * Otherwise, picks `Locales` and `Messages` according to the key.
- */
-type GenConfig<CK extends GenConfigKeys = "__default__"> = IntorGeneratedTypes extends void ? {
-    Locales: string;
-    Messages: LocaleMessages;
-} : CK extends keyof IntorGeneratedTypes ? {
-    Locales: IntorGeneratedTypes[CK]["Locales"];
-    Messages: {
-        [K in IntorGeneratedTypes[CK]["Locales"]]: IntorGeneratedTypes[CK]["Messages"][typeof PREFIX_PLACEHOLDER];
-    };
-} : never;
-/** Extracts messages for a given config key */
-type GenMessages<CK extends GenConfigKeys = "__default__"> = GenConfig<CK>["Messages"];
-/** Extracts locales for a given config key */
-type GenLocale<CK extends GenConfigKeys = "__default__"> = GenConfig<CK>["Locales"];
+declare const TranslateHandlersProvider: ({ children, handlers, }: TranslateHandlersProviderProps) => react_jsx_runtime.JSX.Element;
 
 /** Base properties shared by all translator instances. */
 interface TranslatorBaseProps<M = unknown> {
@@ -216,57 +279,4 @@ type TranslatorInstance<M, PK extends string | undefined = undefined> = {
 declare function useTranslator<CK extends GenConfigKeys = "__default__">(): TranslatorInstance<GenMessages<CK>>;
 declare function useTranslator<CK extends GenConfigKeys = "__default__", PK extends string = LocalizedNodeKeys<GenMessages<CK>>>(preKey: IfGen<PK, string>): TranslatorInstance<GenMessages<CK>, PK>;
 
-interface LinkProps extends Omit<LinkProps$1, "href">, Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
-    href?: Url;
-    locale?: GenLocale;
-}
-/**
- * Localized Link component
- *
- * - Wraps Next.js Link and handles locale switching.
- * - Full reload occurs only if the locale changes and requires it; otherwise updates context.
- */
-declare const Link: ({ href, locale, children, onClick, ...props }: LinkProps) => React.JSX.Element;
-
-/**
- * usePathname hook
- *
- * Wraps Next.js usePathname and returns the current pathname prefixed with the active locale.
- */
-declare const usePathname: () => string;
-
-/**
- * useRouter hook.
- *
- * Wraps Next.js useRouter and provides push/replace methods that automatically switch locale.
- */
-declare const useRouter: () => {
-    back(): void;
-    forward(): void;
-    refresh(): void;
-    prefetch(href: string, options?: next_dist_shared_lib_app_router_context_shared_runtime.PrefetchOptions): void;
-    push: (href: string, options?: NavigateOptions & {
-        locale?: GenLocale;
-    }) => void;
-    replace: (href: string, options?: NavigateOptions & {
-        locale?: Locale;
-    }) => void;
-};
-
-/**
- * redirect utility.
- *
- * - Wraps Next.js redirect and applies locale-aware navigation.
- * - Automatically prefixes the pathname with the correct locale.
- * - External URLs are redirected directly without modification.
- */
-declare const redirect: ({ config, locale, url, type, }: {
-    config: IntorResolvedConfig;
-    locale?: GenLocale;
-    url: string;
-    type?: RedirectType | undefined;
-}) => Promise<never>;
-
-declare const PATHNAME_HEADER_NAME = "x-intor-pathname";
-
-export { IntorProvider, type IntorProviderProps, Link, PATHNAME_HEADER_NAME, TranslateHandlersProvider, type TranslateHandlersProviderProps, redirect, usePathname, useRouter, useTranslator };
+export { IntorProvider, type IntorProviderProps, Link, TranslateHandlersProvider, type TranslateHandlersProviderProps, redirect, usePathname, useRouter, useTranslator };