intor 2.2.14 → 2.2.15

package/dist/next/index.d.cts

@@ -1,282 +0,0 @@
-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 = {
-    /** Enable cookie usage (read/write) - default: true */
-    enabled?: boolean;
-    /** Allow the system to automatically set cookies - default: true */
-    autoSetCookie?: boolean;
-    /** default: "intor.i18n.locale" */
-    name?: string;
-    /** default: null */
-    domain?: string | null;
-    /** default: "/" */
-    path?: string;
-    /** default: 60 * 60 * 24 * 365 (365 days) */
-    maxAge?: number;
-    /** default: false */
-    httpOnly?: boolean;
-    /** default: process.env.NODE_ENV !== "development" */
-    secure?: boolean;
-    /** default: lax */
-    sameSite?: "lax" | "strict" | "none";
-};
-type CookieResolvedOptions = Required<Omit<CookieRawOptions, "domain">> & {
-    domain: string | null;
-};
-
-/**
- * ```ts
- * {
- *  default: ["ui", "meta"],
- *  "/auth": ["auth", "admin"],
- * }
- * // When pathname is "/" => namespaces: ["ui", "meta"]
- * // When pathname is "/auth" => namespaces: ["ui", "meta", "auth", "admin"]
- * ```
- */
-type RouteNamespaces = {
-    [key: string]: string[];
-} | {
-    [key: string]: string[];
-    default: string[];
-};
-interface RemoteHeaders {
-    authorization?: string;
-    "x-api-key"?: string;
-    [key: string]: string | undefined;
-}
-type BaseLoaderOptions = {
-    rootDir?: string;
-    namespaces?: string[];
-    routeNamespaces?: RouteNamespaces;
-    concurrency?: number;
-};
-type LocalLoader = BaseLoaderOptions & {
-    type: "local";
-};
-type RemoteLoader = BaseLoaderOptions & {
-    type: "remote";
-    remoteUrl: string;
-    remoteHeaders?: RemoteHeaders;
-    fullReload?: boolean;
-};
-type LoaderOptions = LocalLoader | RemoteLoader;
-
-type LoggerOptions = {
-    level?: Level;
-    normalizerConfig?: NormalizerConfig;
-    formatterConfig?: FormatterConfig;
-    preset?: LoggerPreset;
-};
-
-declare const routingPrefix: readonly ["none", "all", "except-default"];
-declare const routingFirstVisitLocaleSource: readonly ["default", "browser"];
-type RoutingRawOptions = {
-    /** default: "none" */
-    prefix?: (typeof routingPrefix)[number];
-    firstVisit?: {
-        /** default: "browser" */
-        localeSource?: (typeof routingFirstVisitLocaleSource)[number];
-        /** default: true */
-        redirect?: boolean;
-    };
-    /** default: "" */
-    basePath?: string;
-};
-type RoutingResolvedOptions = Required<RoutingRawOptions>;
-
-type CacheRawOptions = {
-    /** default: process.env.NODE_ENV === "production" */
-    enabled?: boolean;
-    /** default: 60\*60\*1000 (1 hour) */
-    ttl?: number;
-};
-type CacheResolvedOptions = Required<CacheRawOptions>;
-
-type TranslatorOptions = {
-    loadingMessage?: string;
-    placeholder?: string;
-};
-
-type IntorResolvedConfig = ({
-    loader: LoaderOptions;
-    supportedLocales: readonly Locale[];
-} | {
-    loader?: undefined;
-    supportedLocales: readonly Locale[];
-}) & {
-    readonly id: string;
-    readonly messages?: LocaleMessages;
-    readonly defaultLocale: Locale;
-    readonly fallbackLocales: FallbackLocalesMap;
-    readonly translator?: TranslatorOptions;
-    readonly cookie: CookieResolvedOptions;
-    readonly routing: RoutingResolvedOptions;
-    readonly logger?: LoggerOptions;
-    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>;
-        onLocaleChange?: (newLocale: string) => Promise<void> | void;
-        isLoading?: boolean;
-    };
-    children: React.ReactNode;
-}
-
-declare const IntorProvider: ({ value: { config, pathname, initialLocale, messages, onLocaleChange, isLoading, }, children, }: IntorProviderProps) => react_jsx_runtime.JSX.Element;
-
-type TranslateHandlersProviderProps = {
-    handlers: TranslateHandlers;
-    children: React.ReactNode;
-};
-
-declare const TranslateHandlersProvider: ({ handlers, children, }: TranslateHandlersProviderProps) => react_jsx_runtime.JSX.Element;
-
-/** Base properties shared by all translator instances. */
-interface TranslatorBaseProps<M = unknown> {
-    /** `messages`: The message object containing all translations. */
-    messages: M;
-    /** Current locale in use. */
-    locale: Locale<M>;
-}
-/** Properties specific to client-side translator behavior. */
-interface TranslatorClientProps<M = unknown> {
-    /** `isLoading`: Indicates whether translations are currently loading. */
-    isLoading: boolean;
-    /** `setLocale`: Function to update the current locale. */
-    setLocale: (locale: Locale<M>) => void;
-}
-/**
- * Conditional key type for TranslatorInstance.
- * - Resolves to `ScopedLeafKeys` if a pre-key `PK` is provided,
- * otherwise resolves to `LocalizedLeafKeys`.
- */
-type Key<M, PK> = IfGen<PK extends string ? ScopedLeafKeys<M, PK> : LocalizedLeafKeys<M>, string>;
-/**
- * Translator instance type.
- * Combines base props, client props, and core translation methods.
- */
-type TranslatorInstance<M, PK extends string | undefined = undefined> = {
-    /** Check if a given key exists in the messages. */
-    hasKey: (key?: Key<M, PK>, targetLocale?: Locale<M>) => boolean;
-    /** Translate a given key into its string representation. */
-    t: <Result = string>(key?: Key<M, PK>, replacements?: Replacement) => Result;
-} & TranslatorBaseProps<M> & TranslatorClientProps<M>;
-
-/**
- * React hook to access a ready-to-use translator instance in the client.
- *
- * - Provides `t`, `hasKey`, `messages`, `locale`, `isLoading` and `setLocale`.
- * - Supports optional `preKey` to create a scoped translator for nested keys.
- * - Can accept a generic type parameter `M` to strongly type your messages.
- */
-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>;
-
-export { IntorProvider, type IntorProviderProps, Link, TranslateHandlersProvider, type TranslateHandlersProviderProps, redirect, usePathname, useRouter, useTranslator };

package/dist/next/index.d.ts

@@ -1,282 +0,0 @@
-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 = {
-    /** Enable cookie usage (read/write) - default: true */
-    enabled?: boolean;
-    /** Allow the system to automatically set cookies - default: true */
-    autoSetCookie?: boolean;
-    /** default: "intor.i18n.locale" */
-    name?: string;
-    /** default: null */
-    domain?: string | null;
-    /** default: "/" */
-    path?: string;
-    /** default: 60 * 60 * 24 * 365 (365 days) */
-    maxAge?: number;
-    /** default: false */
-    httpOnly?: boolean;
-    /** default: process.env.NODE_ENV !== "development" */
-    secure?: boolean;
-    /** default: lax */
-    sameSite?: "lax" | "strict" | "none";
-};
-type CookieResolvedOptions = Required<Omit<CookieRawOptions, "domain">> & {
-    domain: string | null;
-};
-
-/**
- * ```ts
- * {
- *  default: ["ui", "meta"],
- *  "/auth": ["auth", "admin"],
- * }
- * // When pathname is "/" => namespaces: ["ui", "meta"]
- * // When pathname is "/auth" => namespaces: ["ui", "meta", "auth", "admin"]
- * ```
- */
-type RouteNamespaces = {
-    [key: string]: string[];
-} | {
-    [key: string]: string[];
-    default: string[];
-};
-interface RemoteHeaders {
-    authorization?: string;
-    "x-api-key"?: string;
-    [key: string]: string | undefined;
-}
-type BaseLoaderOptions = {
-    rootDir?: string;
-    namespaces?: string[];
-    routeNamespaces?: RouteNamespaces;
-    concurrency?: number;
-};
-type LocalLoader = BaseLoaderOptions & {
-    type: "local";
-};
-type RemoteLoader = BaseLoaderOptions & {
-    type: "remote";
-    remoteUrl: string;
-    remoteHeaders?: RemoteHeaders;
-    fullReload?: boolean;
-};
-type LoaderOptions = LocalLoader | RemoteLoader;
-
-type LoggerOptions = {
-    level?: Level;
-    normalizerConfig?: NormalizerConfig;
-    formatterConfig?: FormatterConfig;
-    preset?: LoggerPreset;
-};
-
-declare const routingPrefix: readonly ["none", "all", "except-default"];
-declare const routingFirstVisitLocaleSource: readonly ["default", "browser"];
-type RoutingRawOptions = {
-    /** default: "none" */
-    prefix?: (typeof routingPrefix)[number];
-    firstVisit?: {
-        /** default: "browser" */
-        localeSource?: (typeof routingFirstVisitLocaleSource)[number];
-        /** default: true */
-        redirect?: boolean;
-    };
-    /** default: "" */
-    basePath?: string;
-};
-type RoutingResolvedOptions = Required<RoutingRawOptions>;
-
-type CacheRawOptions = {
-    /** default: process.env.NODE_ENV === "production" */
-    enabled?: boolean;
-    /** default: 60\*60\*1000 (1 hour) */
-    ttl?: number;
-};
-type CacheResolvedOptions = Required<CacheRawOptions>;
-
-type TranslatorOptions = {
-    loadingMessage?: string;
-    placeholder?: string;
-};
-
-type IntorResolvedConfig = ({
-    loader: LoaderOptions;
-    supportedLocales: readonly Locale[];
-} | {
-    loader?: undefined;
-    supportedLocales: readonly Locale[];
-}) & {
-    readonly id: string;
-    readonly messages?: LocaleMessages;
-    readonly defaultLocale: Locale;
-    readonly fallbackLocales: FallbackLocalesMap;
-    readonly translator?: TranslatorOptions;
-    readonly cookie: CookieResolvedOptions;
-    readonly routing: RoutingResolvedOptions;
-    readonly logger?: LoggerOptions;
-    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>;
-        onLocaleChange?: (newLocale: string) => Promise<void> | void;
-        isLoading?: boolean;
-    };
-    children: React.ReactNode;
-}
-
-declare const IntorProvider: ({ value: { config, pathname, initialLocale, messages, onLocaleChange, isLoading, }, children, }: IntorProviderProps) => react_jsx_runtime.JSX.Element;
-
-type TranslateHandlersProviderProps = {
-    handlers: TranslateHandlers;
-    children: React.ReactNode;
-};
-
-declare const TranslateHandlersProvider: ({ handlers, children, }: TranslateHandlersProviderProps) => react_jsx_runtime.JSX.Element;
-
-/** Base properties shared by all translator instances. */
-interface TranslatorBaseProps<M = unknown> {
-    /** `messages`: The message object containing all translations. */
-    messages: M;
-    /** Current locale in use. */
-    locale: Locale<M>;
-}
-/** Properties specific to client-side translator behavior. */
-interface TranslatorClientProps<M = unknown> {
-    /** `isLoading`: Indicates whether translations are currently loading. */
-    isLoading: boolean;
-    /** `setLocale`: Function to update the current locale. */
-    setLocale: (locale: Locale<M>) => void;
-}
-/**
- * Conditional key type for TranslatorInstance.
- * - Resolves to `ScopedLeafKeys` if a pre-key `PK` is provided,
- * otherwise resolves to `LocalizedLeafKeys`.
- */
-type Key<M, PK> = IfGen<PK extends string ? ScopedLeafKeys<M, PK> : LocalizedLeafKeys<M>, string>;
-/**
- * Translator instance type.
- * Combines base props, client props, and core translation methods.
- */
-type TranslatorInstance<M, PK extends string | undefined = undefined> = {
-    /** Check if a given key exists in the messages. */
-    hasKey: (key?: Key<M, PK>, targetLocale?: Locale<M>) => boolean;
-    /** Translate a given key into its string representation. */
-    t: <Result = string>(key?: Key<M, PK>, replacements?: Replacement) => Result;
-} & TranslatorBaseProps<M> & TranslatorClientProps<M>;
-
-/**
- * React hook to access a ready-to-use translator instance in the client.
- *
- * - Provides `t`, `hasKey`, `messages`, `locale`, `isLoading` and `setLocale`.
- * - Supports optional `preKey` to create a scoped translator for nested keys.
- * - Can accept a generic type parameter `M` to strongly type your messages.
- */
-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>;
-
-export { IntorProvider, type IntorProviderProps, Link, TranslateHandlersProvider, type TranslateHandlersProviderProps, redirect, usePathname, useRouter, useTranslator };