intor 2.4.8 → 2.4.9

package/README.md

@@ -21,11 +21,6 @@ The i18n library for modern JavaScript
 </div>
 
 > [!NOTE]  
-> Intor began as an internal i18n tool.
->
-> After multiple private iterations, it evolved into a minimal,
-> framework-agnostic translation system.
->
-> **v3 marks its first intentional public release.**
->
-> _Currently available as v2.x. v3 is in active development._
+> Intor is evolving toward long-term stability.  
+> **v3 will be the first fully stable release.**  
+> _Current: v2.x · v3 in development._

package/dist/next/src/adapters/next/create-intor-handler.js

@@ -17,40 +17,42 @@ import { getLocaleFromAcceptLanguage } from '../../routing/locale/get-locale-fro
  *
  * @platform Next.js
  */
-const createIntorHandler = async (config, request) => {
-    const { host, searchParams, pathname: rawPathname } = request.nextUrl;
-    // Locale from Accept-Language header
-    const acceptLanguageHeader = request.headers.get("accept-language");
-    const localeFromAcceptLanguage = getLocaleFromAcceptLanguage(acceptLanguageHeader, config.supportedLocales);
-    // Check whether this navigation flow has already redirected
-    const hasRedirected = request.headers.get(INTOR_HEADERS.REDIRECTED) === "1";
-    // ----------------------------------------------------------
-    // Resolve inbound routing decision (pure computation)
-    // ----------------------------------------------------------
-    const { locale, localeSource, pathname, shouldRedirect } = await resolveInbound(config, rawPathname, {
-        host,
-        query: normalizeQuery(Object.fromEntries(searchParams.entries())),
-        cookie: request.cookies.get(config.cookie.name)?.value,
-        detected: localeFromAcceptLanguage || config.defaultLocale,
-    }, { hasRedirected });
-    // ----------------------------------------------------------
-    // Prepare Next.js response (redirect or pass-through)
-    // ----------------------------------------------------------
-    const url = request.nextUrl.clone();
-    url.pathname = pathname;
-    const response = shouldRedirect
-        ? NextResponse.redirect(url)
-        : NextResponse.next();
-    // ----------------------------------------------------------
-    // Attach routing metadata to response headers
-    // ----------------------------------------------------------
-    response.headers.set(INTOR_HEADERS.LOCALE, locale);
-    response.headers.set(INTOR_HEADERS.LOCALE_SOURCE, localeSource);
-    response.headers.set(INTOR_HEADERS.PATHNAME, pathname);
-    // Mark redirect to prevent infinite loops in this flow
-    if (shouldRedirect)
-        response.headers.set(INTOR_HEADERS.REDIRECTED, "1");
-    return response;
-};
+function createIntorHandler(config) {
+    return async function intorHandler(request) {
+        const { host, searchParams, pathname: rawPathname } = request.nextUrl;
+        // Locale from Accept-Language header
+        const acceptLanguageHeader = request.headers.get("accept-language");
+        const localeFromAcceptLanguage = getLocaleFromAcceptLanguage(acceptLanguageHeader, config.supportedLocales);
+        // Check whether this navigation flow has already redirected
+        const hasRedirected = request.headers.get(INTOR_HEADERS.REDIRECTED) === "1";
+        // ----------------------------------------------------------
+        // Resolve inbound routing decision (pure computation)
+        // ----------------------------------------------------------
+        const { locale, localeSource, pathname, shouldRedirect } = await resolveInbound(config, rawPathname, {
+            host,
+            query: normalizeQuery(Object.fromEntries(searchParams.entries())),
+            cookie: request.cookies.get(config.cookie.name)?.value,
+            detected: localeFromAcceptLanguage || config.defaultLocale,
+        }, { hasRedirected });
+        // ----------------------------------------------------------
+        // Prepare Next.js response (redirect or pass-through)
+        // ----------------------------------------------------------
+        const url = request.nextUrl.clone();
+        url.pathname = pathname;
+        const response = shouldRedirect
+            ? NextResponse.redirect(url)
+            : NextResponse.next();
+        // ----------------------------------------------------------
+        // Attach routing metadata to response headers
+        // ----------------------------------------------------------
+        response.headers.set(INTOR_HEADERS.LOCALE, locale);
+        response.headers.set(INTOR_HEADERS.LOCALE_SOURCE, localeSource);
+        response.headers.set(INTOR_HEADERS.PATHNAME, pathname);
+        // Mark redirect to prevent infinite loops in this flow
+        if (shouldRedirect)
+            response.headers.set(INTOR_HEADERS.REDIRECTED, "1");
+        return response;
+    };
+}
 
 export { createIntorHandler };

package/dist/types/src/adapters/next/create-intor-handler.d.ts

@@ -1,5 +1,6 @@
 import type { IntorResolvedConfig } from "../../config";
 import type { NextRequest } from "next/server";
+import { NextResponse } from "next/server";
 /**
  * Resolves locale-aware routing for the current execution context.
  *
@@ -9,4 +10,4 @@ import type { NextRequest } from "next/server";
  *
  * @platform Next.js
  */
-export declare const createIntorHandler: (config: IntorResolvedConfig, request: NextRequest) => Promise<Response>;
+export declare function createIntorHandler(config: IntorResolvedConfig): (request: NextRequest) => Promise<NextResponse<unknown>>;

package/dist/types/src/core/index.d.ts

@@ -5,4 +5,4 @@ export { getLogger, clearLoggerPool } from "./logger";
 export { loadRemoteMessages, mergeMessages, isValidMessages, nestObjectFromPath, type MessagesReader, type MessagesReaders, INTOR_PREFIX, INTOR_MESSAGES_KIND_KEY, INTOR_MESSAGES_KIND, getMessagesKind, type IntorMessagesKind, } from "./messages";
 export { createHtmlRenderer, type TagRenderers, type HtmlTagRenderers, } from "./render";
 export { createTranslator, type CreateTranslatorParams, createTRich, } from "./translator";
-export type { INTOR_GENERATED_KEY, IfGen, GenConfigKeys, GenConfig, GenMessages, GenLocale, GenReplacements, GenRich, TranslatorInstance, RoutingLocaleSource, RoutingLocaleCarrier, LocalePathPrefix, RuntimeFetch, } from "./types";
+export type { INTOR_GENERATED_KEY, GenConfigKeys, GenConfig, GenMessages, GenLocale, GenReplacements, GenRich, TranslatorInstance, RoutingLocaleSource, RoutingLocaleCarrier, LocalePathPrefix, RuntimeFetch, } from "./types";

package/dist/types/src/core/types/generated.d.ts

@@ -1,41 +1,44 @@
 import type { PREFIX_PLACEHOLDER } from "../constants";
 import type { Locale, LocaleMessages, Replacement, Rich } from "intor-translator";
 /**
- * ================================================
- * Generated-aware type system for Intor.
- *
- * This module defines conditional and fallback types that adapt
- * based on whether generated types are present.
- * ================================================
+ * =================================================
+ * Generated-aware type system for Intor
+ * =================================================
  */
 /**
- * Internal sentinel key indicating that Intor generated types are present.
- * - Used by conditional types to switch between fallback and generated modes.
- * - Type-level only. Not for runtime or user-facing usage.
+ * Sentinel key injected by CLI when generated types exist.
+ * Used purely for type-level generation detection.
  */
 export type INTOR_GENERATED_KEY = "__intor_generated__";
 /**
- * Conditional type for generated types.
- * - Uses key presence on `IntorGeneratedTypes` to detect generation.
+ * Detect whether generated types are present.
  */
-export type IfGen<Then, Else = never> = IntorGeneratedTypes extends {
+type HasGenerated = IntorGeneratedTypes extends {
     [K in INTOR_GENERATED_KEY]: true;
-} ? Then : Else;
+} ? true : false;
 /**
- * Config keys provided by generated types.
- * - Excludes internal sentinel
+ * Extract valid configuration keys from generated types.
+ * (Excludes sentinel key.)
  */
 type GeneratedConfigKeys = Exclude<keyof IntorGeneratedTypes, INTOR_GENERATED_KEY>;
 /**
- * Union of all configuration keys.
- * - Defaults to `string` if `IntorGeneratedTypes` does not exist.
+ * Public configuration key union.
+ * Falls back to `string` in non-generated mode.
+ */
+export type GenConfigKeys = HasGenerated extends true ? GeneratedConfigKeys : string;
+/**
+ * Fallback configuration shape (non-generated mode).
  */
-export type GenConfigKeys = IfGen<GeneratedConfigKeys, string>;
+type FallbackConfig = {
+    Locales: Locale;
+    Messages: LocaleMessages;
+    Replacements: Replacement;
+    Rich: Rich;
+};
 /**
- * Configuration shape for a given config key.
- * - If `IntorGeneratedTypes` is not defined, falls back to default shape.
+ * Extract generated configuration shape safely.
  */
-export type GenConfig<CK extends GenConfigKeys> = IfGen<CK extends keyof IntorGeneratedTypes ? IntorGeneratedTypes[CK] extends {
+type ExtractGeneratedConfig<T> = T extends {
     Locales: infer L extends string;
     Messages: Record<typeof PREFIX_PLACEHOLDER, infer M>;
     Replacements: infer RE;
@@ -45,18 +48,19 @@ export type GenConfig<CK extends GenConfigKeys> = IfGen<CK extends keyof IntorGe
     Messages: Record<L, M>;
     Replacements: RE;
     Rich: RI;
-} : never : never, {
-    Locales: Locale;
-    Messages: LocaleMessages;
-    Replacements: Replacement;
-    Rich: Rich;
-}>;
-/** Resolves message schema for a given config key */
+} : never;
+/**
+ * Configuration shape resolver.
+ *
+ * - Uses generated types when available.
+ * - Falls back to default shape otherwise.
+ */
+export type GenConfig<CK extends GenConfigKeys> = HasGenerated extends true ? CK extends GeneratedConfigKeys ? ExtractGeneratedConfig<IntorGeneratedTypes[CK]> : never : FallbackConfig;
+/**
+ * Derived helpers
+ */
 export type GenMessages<CK extends GenConfigKeys> = GenConfig<CK>["Messages"];
-/** Resolves locale union for a given config key */
 export type GenLocale<CK extends GenConfigKeys> = GenConfig<CK>["Locales"];
-/** Resolves replacement schema for a given config key */
 export type GenReplacements<CK extends GenConfigKeys> = GenConfig<CK>["Replacements"];
-/** Resolves rich tag schema for a given config key */
 export type GenRich<CK extends GenConfigKeys> = GenConfig<CK>["Rich"];
 export {};

package/dist/types/src/core/types/index.d.ts

@@ -1,4 +1,4 @@
-export type { INTOR_GENERATED_KEY, IfGen, GenConfigKeys, GenConfig, GenMessages, GenLocale, GenReplacements, GenRich, } from "./generated";
+export type { INTOR_GENERATED_KEY, GenConfigKeys, GenConfig, GenMessages, GenLocale, GenReplacements, GenRich, } from "./generated";
 export type { TranslatorInstance } from "./translator-instance";
 export type { RoutingLocaleSource, RoutingLocaleCarrier, LocalePathPrefix, } from "./routing";
 export type { RuntimeFetch } from "./runtime-fetch";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intor",
-  "version": "2.4.8",
+  "version": "2.4.9",
   "description": "The i18n library for modern JavaScript",
   "author": "Yiming Liao",
   "homepage": "https://github.com/yiming-liao/intor#readme",