intor 2.2.13 → 2.2.15

package/dist/react/index.d.cts

@@ -1,224 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-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';
-
-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;
-};
-
-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;
-
-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"];
-
-/** 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>;
-
-/**
- * Get the initial locale from cookie, browser, or default.
- *
- * - This function is intended for client-side use only.
- *
- * @param {IntorResolvedConfig} config - The intor configuration.
- * @param {string} [cookieName=config.cookie.name] - Optional cookie name to check.
- * @returns {string} The matched locale or the default locale.
- */
-declare function getInitialLocale(config: IntorResolvedConfig, cookieName?: string): string;
-
-export { IntorProvider, type IntorProviderProps, TranslateHandlersProvider, type TranslateHandlersProviderProps, getInitialLocale, useTranslator };

package/dist/react/index.d.ts

@@ -1,224 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-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';
-
-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;
-};
-
-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;
-
-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"];
-
-/** 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>;
-
-/**
- * Get the initial locale from cookie, browser, or default.
- *
- * - This function is intended for client-side use only.
- *
- * @param {IntorResolvedConfig} config - The intor configuration.
- * @param {string} [cookieName=config.cookie.name] - Optional cookie name to check.
- * @returns {string} The matched locale or the default locale.
- */
-declare function getInitialLocale(config: IntorResolvedConfig, cookieName?: string): string;
-
-export { IntorProvider, type IntorProviderProps, TranslateHandlersProvider, type TranslateHandlersProviderProps, getInitialLocale, useTranslator };