intor 2.4.17 → 2.5.0

package/dist/svelte/src/core/locale/canonicalize-locale.js

@@ -1,23 +0,0 @@
-/**
- * Canonicalizes a BCP 47 locale string.
- *
- * - Uses `Intl.getCanonicalLocales` when available.
- * - Returns the original input if `Intl` is unavailable.
- * - Returns `undefined` for invalid locale input.
- *
- * This function performs normalization only.
- * It does not perform matching or fallback.
- */
-function canonicalizeLocale(input) {
-    try {
-        if (typeof Intl === "undefined" || !Intl.getCanonicalLocales) {
-            return input;
-        }
-        return Intl.getCanonicalLocales(input)[0];
-    }
-    catch {
-        return;
-    }
-}
-
-export { canonicalizeLocale };

package/dist/svelte/src/core/locale/match-locale.js

@@ -1,57 +0,0 @@
-import { canonicalizeLocale } from './canonicalize-locale.js';
-import { parseLocale } from './parse-locale.js';
-
-/**
- * Matches a locale candidate against a list of supported locales.
- *
- * Resolution order:
- * 1. Exact canonical match
- * 2. Same language + same script
- * 3. Same language only (only if candidate has no script)
- *
- * Returns `undefined` if no match is found.
- *
- * Notes:
- * - Matching is deterministic and order-sensitive.
- * - Does not perform automatic fallback to default locale.
- * - Does not cross script boundaries.
- */
-function matchLocale(locale, supportedLocales = []) {
-    if (!locale || supportedLocales.length === 0)
-        return;
-    const canonicalCandidate = canonicalizeLocale(locale);
-    if (!canonicalCandidate)
-        return;
-    const candidateParts = parseLocale(canonicalCandidate);
-    const supportedCanonical = supportedLocales.flatMap((original) => {
-        const canonical = canonicalizeLocale(original);
-        if (!canonical)
-            return [];
-        return [{ original, canonical, parts: parseLocale(canonical) }];
-    });
-    // 1. Exact match
-    for (const s of supportedCanonical) {
-        if (s.canonical === canonicalCandidate) {
-            return s.original;
-        }
-    }
-    // 2. Same language + same script
-    if (candidateParts.script) {
-        for (const s of supportedCanonical) {
-            if (s.parts.language === candidateParts.language &&
-                s.parts.script === candidateParts.script) {
-                return s.original;
-            }
-        }
-        return;
-    }
-    // 3. Same language only
-    for (const s of supportedCanonical) {
-        if (s.parts.language === candidateParts.language) {
-            return s.original;
-        }
-    }
-    return;
-}
-
-export { matchLocale };

package/dist/svelte/src/core/locale/parse-locale.js

@@ -1,27 +0,0 @@
-/**
- * Parses a canonical locale tag into structural components.
- *
- * - Uses `Intl.Locale` when available.
- * - Falls back to minimal parsing (language only) if unavailable.
- *
- * This function does not validate or match locales.
- */
-function parseLocale(tag) {
-    try {
-        if (typeof Intl !== "undefined" && typeof Intl.Locale === "function") {
-            const locale = new Intl.Locale(tag);
-            return {
-                language: locale.language,
-                script: locale.script,
-                region: locale.region,
-            };
-        }
-    }
-    catch {
-        // fallback below
-    }
-    const parts = tag.split("-");
-    return { language: parts[0].toLowerCase() };
-}
-
-export { parseLocale };

package/dist/svelte-kit/src/core/error/intor-error.js

@@ -1,9 +0,0 @@
-var IntorErrorCode;
-(function (IntorErrorCode) {
-    // config
-    IntorErrorCode["INVALID_CONFIG_ID"] = "INTOR_INVALID_CONFIG_ID";
-    IntorErrorCode["MISSING_SUPPORTED_LOCALES"] = "INTOR_MISSING_SUPPORTED_LOCALES";
-    IntorErrorCode["UNSUPPORTED_DEFAULT_LOCALE"] = "INTOR_UNSUPPORTED_DEFAULT_LOCALE";
-})(IntorErrorCode || (IntorErrorCode = {}));
-
-export { IntorErrorCode };

package/dist/svelte-kit/src/routing/inbound/resolve-path/resolve-path.js

@@ -1,42 +0,0 @@
-import { localizePathname } from '../../pathname/localize-pathname.js';
-import { all } from './strategies/all.js';
-import { exceptDefault } from './strategies/except-default.js';
-import { none } from './strategies/none.js';
-
-const assertNever = (x) => {
-    throw new Error(`Unhandled prefix strategy: ${x}`);
-};
-/**
- * Resolves the canonical pathname based on locale prefix behavior.
- *
- * The resolved pathname represents the final, normalized form
- * used for routing and navigation.
- */
-const resolvePath = (config, rawPathname, context) => {
-    const { localePrefix } = config.routing;
-    let directive;
-    switch (localePrefix) {
-        case "all": {
-            directive = all(config, context);
-            break;
-        }
-        case "except-default": {
-            directive = exceptDefault(config, context);
-            break;
-        }
-        case "none": {
-            directive = none();
-            break;
-        }
-        default: {
-            return assertNever(localePrefix);
-        }
-    }
-    const { pathname } = localizePathname(rawPathname, config, context.locale);
-    return {
-        pathname,
-        shouldRedirect: directive.type === "redirect",
-    };
-};
-
-export { resolvePath };

package/dist/types/src/adapters/express/global.d.ts

@@ -1,18 +0,0 @@
-import type { TranslatorInstance } from "../../core";
-import type { InboundContext } from "../../routing";
-import type { LocaleMessages } from "intor-translator";
-/**
- * Global type augmentations for Express request
- */
-declare global {
-    namespace Express {
-        interface Request {
-            intor: InboundContext;
-            locale: TranslatorInstance<LocaleMessages>["locale"];
-            hasKey: TranslatorInstance<LocaleMessages>["hasKey"];
-            t: TranslatorInstance<LocaleMessages>["t"];
-            tRich: TranslatorInstance<LocaleMessages>["tRich"];
-        }
-    }
-}
-export {};

package/dist/types/src/adapters/fastify/global.d.ts

@@ -1,17 +0,0 @@
-import "fastify";
-import type { TranslatorInstance } from "../../core";
-import type { InboundContext } from "../../routing";
-import type { LocaleMessages } from "intor-translator";
-/**
- * Global type augmentations for Fastify request
- */
-declare module "fastify" {
-    interface FastifyRequest {
-        intor: InboundContext;
-        locale: TranslatorInstance<LocaleMessages>["locale"];
-        hasKey: TranslatorInstance<LocaleMessages>["hasKey"];
-        t: TranslatorInstance<LocaleMessages>["t"];
-        tRich: TranslatorInstance<LocaleMessages>["tRich"];
-    }
-}
-export {};

package/dist/types/src/adapters/hono/global.d.ts

@@ -1,17 +0,0 @@
-import "hono";
-import type { TranslatorInstance } from "../../core";
-import type { InboundContext } from "../../routing";
-import type { LocaleMessages } from "intor-translator";
-/**
- * Global type augmentations for Hono context variables
- */
-declare module "hono" {
-    interface ContextVariableMap {
-        intor: InboundContext;
-        locale: TranslatorInstance<LocaleMessages>["locale"];
-        hasKey: TranslatorInstance<LocaleMessages>["hasKey"];
-        t: TranslatorInstance<LocaleMessages>["t"];
-        tRich: TranslatorInstance<LocaleMessages>["tRich"];
-    }
-}
-export {};

package/dist/types/src/client/react/translator/trans.d.ts

@@ -1,18 +0,0 @@
-import type { ReactTagRenderers } from "../render";
-import type { GenConfigKeys, GenMessages, GenReplacements, GenRich } from "../../../core";
-import type { LocalizedKey, LocalizedReplacement, LocalizedRich, Replacement } from "intor-translator";
-type TransProps<CK extends GenConfigKeys = "__default__", K extends string = LocalizedKey<GenMessages<CK>>, RI = LocalizedRich<GenRich<CK>, K>, RE extends Replacement = LocalizedReplacement<GenReplacements<CK>, K>> = {
-    /** The message key to translate. */
-    i18nKey: K | (string & {});
-    /** Optional React renderers for semantic tags. */
-    components?: ReactTagRenderers<RI> | ReactTagRenderers;
-    /** Optional replacement values for interpolation. */
-    values?: RE | Replacement;
-};
-/**
- * `<Trans />` is a lightweight React component for rendering rich translations.
- *
- * It is a thin adapter around `translator.tRich` and introduces no additional logic.
- */
-export declare function Trans<CK extends GenConfigKeys = "__default__">(props: TransProps<CK>): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/types/src/client/react/translator/translator-instance.d.ts

@@ -1,12 +0,0 @@
-import type { ReactTagRenderers } from "../render";
-import type { TranslatorInstance } from "../../../core";
-import type { JSX } from "react/jsx-runtime";
-import { type Locale, type LocaleMessages, type LocalizedKey, type LocalizedReplacement, type LocalizedRich, type Replacement, type Rich, type ScopedKey, type ScopedReplacement, type ScopedRich } from "intor-translator";
-export type TranslatorInstanceReact<M extends LocaleMessages, ReplacementSchema = Replacement, RichSchema = Rich, PK extends string | undefined = undefined> = Omit<TranslatorInstance<M, ReplacementSchema, RichSchema, PK>, "tRich"> & {
-    /** Indicates whether translations are currently loading. */
-    isLoading: boolean;
-    /** Update the active locale. */
-    setLocale: (locale: Locale<M>) => void;
-    /** Translate a key into React nodes using semantic tags */
-    tRich: <K extends string = PK extends string ? ScopedKey<M, PK> : LocalizedKey<M>, RI = PK extends string ? ScopedRich<RichSchema, PK, K> : LocalizedRich<RichSchema, K>, RE = PK extends string ? ScopedReplacement<ReplacementSchema, PK, K> : LocalizedReplacement<ReplacementSchema, K>>(key?: K | (string & {}), tagRenderers?: ReactTagRenderers<RI> | ReactTagRenderers, replacements?: RE | Replacement) => JSX.Element[];
-};

package/dist/types/src/client/svelte/provider/use-intor-context.d.ts

@@ -1,2 +0,0 @@
-import type { IntorContextValue } from "./types";
-export declare function useIntorContext(): IntorContextValue;

package/dist/types/src/client/svelte/translator/translator-instance.d.ts

@@ -1,19 +0,0 @@
-import type { TranslatorInstance } from "../../../core";
-import { type Locale, type LocaleMessages, type Replacement, type Rich } from "intor-translator";
-import { type Readable, type Writable } from "svelte/store";
-export type TranslatorInstanceSvelte<M extends LocaleMessages, ReplacementSchema = Replacement, RichSchema = Rich, PK extends string | undefined = undefined> = {
-    /** `messages`: The message object containing all translations. */
-    messages: Readable<TranslatorInstance<M, ReplacementSchema, RichSchema, PK>["messages"]>;
-    /** Current locale in use. */
-    locale: Writable<TranslatorInstance<M, ReplacementSchema, RichSchema, PK>["locale"]>;
-    /** Indicates whether translations are currently loading. */
-    isLoading: Readable<boolean>;
-    /** Update the active locale. */
-    setLocale: (locale: Locale<M>) => void;
-    /** Check if a given key exists in the messages. */
-    hasKey: Readable<TranslatorInstance<M, ReplacementSchema, RichSchema, PK>["hasKey"]>;
-    /** Translate a given key into its string representation. */
-    t: Readable<TranslatorInstance<M, ReplacementSchema, RichSchema, PK>["t"]>;
-    /** Translate a key into an HTML string using semantic rich tags. */
-    tRich: Readable<TranslatorInstance<M, ReplacementSchema, RichSchema, PK>["tRich"]>;
-};

package/dist/types/src/client/vue/provider/inject.d.ts

@@ -1,3 +0,0 @@
-import type { IntorContextValue } from "./types";
-import { type ComputedRef } from "vue";
-export declare function injectIntor(): ComputedRef<IntorContextValue>;

package/dist/types/src/client/vue/translator/translator-instance.d.ts

@@ -1,16 +0,0 @@
-import type { VueTagRenderers } from "../../../client/vue/render";
-import type { TranslatorInstance } from "../../../core";
-import type { ComputedRef, VNodeChild } from "vue";
-import { type Locale, type LocaleMessages, type LocalizedKey, type LocalizedReplacement, type LocalizedRich, type Replacement, type Rich, type ScopedKey, type ScopedReplacement, type ScopedRich } from "intor-translator";
-export type TranslatorInstanceVue<M extends LocaleMessages, ReplacementSchema = Replacement, RichSchema = Rich, PK extends string | undefined = undefined> = Omit<TranslatorInstance<M, ReplacementSchema, RichSchema, PK>, "tRich" | "messages" | "locale"> & {
-    /** `messages`: The message object containing all translations. */
-    messages: ComputedRef<M>;
-    /** Current locale in use. */
-    locale: ComputedRef<Locale<M>>;
-    /** Indicates whether translations are currently loading. */
-    isLoading: ComputedRef<boolean>;
-    /** Update the active locale. */
-    setLocale: (locale: Locale<M>) => void;
-    /** Translate a key into VNodes using semantic tags */
-    tRich: <K extends string = PK extends string ? ScopedKey<M, PK> : LocalizedKey<M>, RI = PK extends string ? ScopedRich<RichSchema, PK, K> : LocalizedRich<RichSchema, K>, RE = PK extends string ? ScopedReplacement<ReplacementSchema, PK, K> : LocalizedReplacement<ReplacementSchema, K>>(key?: K | (string & {}), tagRenderers?: VueTagRenderers<RI> | VueTagRenderers, replacements?: RE | Replacement) => VNodeChild[];
-};

package/dist/types/src/core/types/translator-instance.d.ts

@@ -1,21 +0,0 @@
-import type { HtmlTagRenderers } from "../render";
-import { type Locale, type LocaleMessages, type LocalizedKey, type ScopedKey, type LocalizedValue, type ScopedValue, type Replacement, type LocalizedReplacement, type LocalizedRich, type Rich, type ScopedRich, type ScopedReplacement } from "intor-translator";
-type FallbackIfNever<T, Fallback> = [T] extends [never] ? Fallback : T;
-/**
- * Core translator instance interface.
- *
- * This type represents the minimal, framework-independent translator contract.
- */
-export type TranslatorInstance<M extends LocaleMessages, ReplacementSchema = Replacement, RichSchema = Rich, PK extends string | undefined = undefined> = {
-    /** `messages`: The message object containing all translations. */
-    messages: M;
-    /** Current locale in use. */
-    locale: Locale<M>;
-    /** Check if a given key exists in the messages. */
-    hasKey: <K extends string = PK extends string ? ScopedKey<M, PK> : LocalizedKey<M>>(key?: K | (string & {}), targetLocale?: Locale<M>) => boolean;
-    /** Translate a given key into its string representation. */
-    t: <K extends string = PK extends string ? ScopedKey<M, PK> : LocalizedKey<M>, R extends Replacement = LocalizedReplacement<ReplacementSchema, K>>(key?: K | (string & {}), replacements?: R | Replacement) => FallbackIfNever<PK extends string ? ScopedValue<M, PK, K> : LocalizedValue<M, K>, string>;
-    /** Translate a key into an HTML string using semantic rich tags. */
-    tRich: <K extends string = PK extends string ? ScopedKey<M, PK> : LocalizedKey<M>, RI = PK extends string ? ScopedRich<RichSchema, PK, K> : LocalizedRich<RichSchema, K>, RE = PK extends string ? ScopedReplacement<ReplacementSchema, PK, K> : LocalizedReplacement<ReplacementSchema, K>>(key?: K | (string & {}), tagRenderers?: HtmlTagRenderers<RI> | HtmlTagRenderers, replacements?: RE | Replacement) => string;
-};
-export {};

package/dist/types/src/routing/inbound/resolve-path/index.d.ts

@@ -1 +0,0 @@
-export { resolvePath as resolvePathname } from "./resolve-path";

package/dist/types/src/server/translator/types.d.ts

@@ -1,9 +0,0 @@
-import type { IntorResolvedConfig } from "../../config";
-import type { LocaleMessages } from "intor-translator";
-/**
- * Runtime message loader override.
- *
- * Loads locale messages imperatively at runtime, bypassing
- * message loading defined in the Intor config.
- */
-export type MessagesLoader = (config: IntorResolvedConfig, locale: string) => Promise<LocaleMessages>;

package/dist/vue/src/client/shared/helpers/get-client-locale.js

@@ -1,22 +0,0 @@
-import '../../../core/error/intor-error.js';
-import { matchLocale } from '../../../core/locale/match-locale.js';
-import 'logry';
-import 'p-limit';
-import 'intor-translator';
-import { detectBrowserLocale } from '../utils/locale/detect-browser-locale.js';
-import { getLocaleFromCookie } from '../utils/locale/get-locale-from-cookie.js';
-
-/**
- * Resolve the active locale in a pure client-side environment.
- */
-function getClientLocale(config) {
-    const { defaultLocale, supportedLocales, cookie } = config;
-    // Locale from browser cookie
-    const cookieLocale = getLocaleFromCookie(cookie.name);
-    // Locale from browser preference
-    const browserLocale = detectBrowserLocale();
-    const localeCandidate = cookieLocale || browserLocale;
-    return matchLocale(localeCandidate, supportedLocales) || defaultLocale;
-}
-
-export { getClientLocale };

package/dist/vue/src/client/shared/utils/locale/detect-browser-locale.js

@@ -1,12 +0,0 @@
-/**
- * Detect the preferred locale from the browser.
- *
- * This function relies on `navigator.languages` and `navigator.language`.
- */
-function detectBrowserLocale() {
-    if (typeof navigator === "undefined")
-        return undefined;
-    return navigator.languages?.[0] || navigator.language || undefined;
-}
-
-export { detectBrowserLocale };

package/dist/vue/src/core/error/intor-error.js

@@ -1,9 +0,0 @@
-var IntorErrorCode;
-(function (IntorErrorCode) {
-    // config
-    IntorErrorCode["INVALID_CONFIG_ID"] = "INTOR_INVALID_CONFIG_ID";
-    IntorErrorCode["MISSING_SUPPORTED_LOCALES"] = "INTOR_MISSING_SUPPORTED_LOCALES";
-    IntorErrorCode["UNSUPPORTED_DEFAULT_LOCALE"] = "INTOR_UNSUPPORTED_DEFAULT_LOCALE";
-})(IntorErrorCode || (IntorErrorCode = {}));
-
-export { IntorErrorCode };

package/dist/vue/src/core/locale/canonicalize-locale.js

@@ -1,23 +0,0 @@
-/**
- * Canonicalizes a BCP 47 locale string.
- *
- * - Uses `Intl.getCanonicalLocales` when available.
- * - Returns the original input if `Intl` is unavailable.
- * - Returns `undefined` for invalid locale input.
- *
- * This function performs normalization only.
- * It does not perform matching or fallback.
- */
-function canonicalizeLocale(input) {
-    try {
-        if (typeof Intl === "undefined" || !Intl.getCanonicalLocales) {
-            return input;
-        }
-        return Intl.getCanonicalLocales(input)[0];
-    }
-    catch {
-        return;
-    }
-}
-
-export { canonicalizeLocale };

package/dist/vue/src/core/locale/match-locale.js

@@ -1,57 +0,0 @@
-import { canonicalizeLocale } from './canonicalize-locale.js';
-import { parseLocale } from './parse-locale.js';
-
-/**
- * Matches a locale candidate against a list of supported locales.
- *
- * Resolution order:
- * 1. Exact canonical match
- * 2. Same language + same script
- * 3. Same language only (only if candidate has no script)
- *
- * Returns `undefined` if no match is found.
- *
- * Notes:
- * - Matching is deterministic and order-sensitive.
- * - Does not perform automatic fallback to default locale.
- * - Does not cross script boundaries.
- */
-function matchLocale(locale, supportedLocales = []) {
-    if (!locale || supportedLocales.length === 0)
-        return;
-    const canonicalCandidate = canonicalizeLocale(locale);
-    if (!canonicalCandidate)
-        return;
-    const candidateParts = parseLocale(canonicalCandidate);
-    const supportedCanonical = supportedLocales.flatMap((original) => {
-        const canonical = canonicalizeLocale(original);
-        if (!canonical)
-            return [];
-        return [{ original, canonical, parts: parseLocale(canonical) }];
-    });
-    // 1. Exact match
-    for (const s of supportedCanonical) {
-        if (s.canonical === canonicalCandidate) {
-            return s.original;
-        }
-    }
-    // 2. Same language + same script
-    if (candidateParts.script) {
-        for (const s of supportedCanonical) {
-            if (s.parts.language === candidateParts.language &&
-                s.parts.script === candidateParts.script) {
-                return s.original;
-            }
-        }
-        return;
-    }
-    // 3. Same language only
-    for (const s of supportedCanonical) {
-        if (s.parts.language === candidateParts.language) {
-            return s.original;
-        }
-    }
-    return;
-}
-
-export { matchLocale };

package/dist/vue/src/core/locale/parse-locale.js

@@ -1,27 +0,0 @@
-/**
- * Parses a canonical locale tag into structural components.
- *
- * - Uses `Intl.Locale` when available.
- * - Falls back to minimal parsing (language only) if unavailable.
- *
- * This function does not validate or match locales.
- */
-function parseLocale(tag) {
-    try {
-        if (typeof Intl !== "undefined" && typeof Intl.Locale === "function") {
-            const locale = new Intl.Locale(tag);
-            return {
-                language: locale.language,
-                script: locale.script,
-                region: locale.region,
-            };
-        }
-    }
-    catch {
-        // fallback below
-    }
-    const parts = tag.split("-");
-    return { language: parts[0].toLowerCase() };
-}
-
-export { parseLocale };