intor 2.3.15 → 2.3.16

package/dist/core/export/index.js

@@ -10,4 +10,4 @@ export { mergeMessages } from '../src/core/messages/merge-messages.js';
 export { defineIntorConfig } from '../src/config/define-intor-config.js';
 import '../src/config/constants/cookie.js';
 export { localizePathname } from '../src/routing/pathname/localize-pathname.js';
-export { Translator } from 'intor-translator';
+export { Translator, tokenize } from 'intor-translator';

package/dist/core/src/routing/pathname/{get-unprefixed-pathname.js → canonicalize-pathname.js}

@@ -10,11 +10,11 @@ import 'logry';
  * // config.supportedLocales: ["en-US"]
  * // config.routing.basePath: "/app"
  * // config.routing.prefix: "all"
- * getUnprefixedPathname(config, "/app/en-US/about" );
+ * canonicalizePathname("/app/en-US/about", config);
  * // => "/about"
  *```
  */
-function getUnprefixedPathname(config, rawPathname) {
+function canonicalizePathname(rawPathname, config) {
     const { routing, supportedLocales } = config;
     const { basePath } = routing;
     // 1. Normalize pathname
@@ -38,4 +38,4 @@ function getUnprefixedPathname(config, rawPathname) {
         : prefixedPathname;
 }
 
-export { getUnprefixedPathname };
+export { canonicalizePathname };

package/dist/core/src/routing/pathname/localize-pathname.js

@@ -1,5 +1,5 @@
-import { getUnprefixedPathname } from './get-unprefixed-pathname.js';
-import { localePrefixPathname } from './locale-prefix-pathname.js';
+import { canonicalizePathname } from './canonicalize-pathname.js';
+import { materializePathname } from './materialize-pathname.js';
 import { standardizePathname } from './standardize-pathname.js';
 
 /**
@@ -11,25 +11,25 @@ import { standardizePathname } from './standardize-pathname.js';
  * // config.supportedLocales: ["en-US"]
  * // config.routing.basePath: "/app"
  * // config.routing.prefix: "all"
- * localePrefixPathname({ config, pathname: "/app/en-US/about", locale: "en-US" });
+ * localizePathname(config, "/app/en-US/about", "en-US");
  * // => {
+ * //   pathname: '/app/en-US/about'
  * //   unprefixedPathname: '/about',
- * //   standardizedPathname: '/app/{locale}/about',
- * //   localizedPathname: '/app/en-US/about'
+ * //   templatedPathname: '/app/{locale}/about',
  * // }
  * ```
  */
-const localizePathname = (config, rawPathname, locale) => {
-    // 1. Canonicalize: extract basePath and strip locale
-    const unprefixedPathname = getUnprefixedPathname(config, rawPathname);
-    // 2. Standardize: build a pathname with locale placeholder
-    const standardizedPathname = standardizePathname(config, unprefixedPathname);
-    // 3. Apply strategy: resolve locale prefix based on routing rules
-    const pathname = localePrefixPathname(config, standardizedPathname, locale);
+const localizePathname = (rawPathname, config, locale) => {
+    // 1. Canonicalize: normalize and remove routing-specific prefixes
+    const canonicalized = canonicalizePathname(rawPathname, config);
+    // 2. Standardize: convert to internal pathname shape with locale placeholder
+    const standardized = standardizePathname(canonicalized, config);
+    // 3. Materialize: apply routing rules to produce the final pathname
+    const materialized = materializePathname(standardized, config, locale);
     return {
-        pathname,
-        unprefixedPathname,
-        standardizedPathname,
+        pathname: materialized,
+        unprefixedPathname: canonicalized,
+        templatedPathname: standardized,
     };
 };
 

package/dist/{next/src/routing/pathname/locale-prefix-pathname.js → core/src/routing/pathname/materialize-pathname.js}

@@ -4,20 +4,21 @@ import { normalizePathname } from '../../core/utils/normalizers/normalize-pathna
 import 'logry';
 
 /**
- * Applies the configured locale prefix behavior to a standardized pathname.
+ * Materializes a standardized pathname by applying
+ * the configured locale prefix behavior.
  *
  * @example
  * ```ts
  * // config.routing.localePrefix: "all"
- * localePrefixPathname({ config, pathname: "/app/{locale}/about", locale: "en-US" });
+ * materializePathname("/app/{locale}/about", config, "en-US");
  * // => /app/en-US/about
  *
  * // config.routing.localePrefix: "none"
- * localePrefixPathname({ config, pathname: "/app/{locale}/about", locale: "en-US" });
+ * materializePathname("/app/{locale}/about", config, "en-US");
  * // => /app/about
  * ```
  */
-const localePrefixPathname = (config, standardizedPathname, locale) => {
+const materializePathname = (standardizedPathname, config, locale) => {
     const { localePrefix } = config.routing;
     if (localePrefix !== "none" && !locale) {
         throw new Error('No locale when using localePrefix "all", "except-default"');
@@ -36,4 +37,4 @@ const localePrefixPathname = (config, standardizedPathname, locale) => {
     return normalizePathname(standardizedPathname.replaceAll(`/${PREFIX_PLACEHOLDER}`, ""));
 };
 
-export { localePrefixPathname };
+export { materializePathname };

package/dist/core/src/routing/pathname/standardize-pathname.js

@@ -4,24 +4,24 @@ import { normalizePathname } from '../../core/utils/normalizers/normalize-pathna
 import 'logry';
 
 /**
- * Standardizes a canonical pathname by applying the base path
- * and injecting the locale placeholder.
+ * Standardizes a canonical pathname into an internal routing template
+ * by applying the base path and injecting a locale placeholder.
  *
  * @example
  * ```ts
- * // routing.basePath: "/app",
- * standardizePathname({ config, pathname: "/cms" });
- * // => "/app/{locale}/cms"
+ * // config.routing.basePath: "/app",
+ * // config.routing.prefix: "all"
+ * standardizePathname("/about", config);
+ * // => "/app/{locale}/about"
  * ```
  */
-const standardizePathname = (config, unprefixedPathname) => {
-    const { routing } = config;
-    const { basePath } = routing;
+const standardizePathname = (canonicalizedPathname, config) => {
+    const { basePath } = config.routing;
     // Normalize each segment before join to avoid redundant slashes
     const parts = [
         normalizePathname(basePath),
         PREFIX_PLACEHOLDER,
-        normalizePathname(unprefixedPathname),
+        normalizePathname(canonicalizedPathname),
     ];
     // Avoid double slashes between segments
     const standardizedPathname = parts.join("/").replaceAll(/\/{2,}/g, "/");

package/dist/core/src/server/helpers/get-translator.js

@@ -21,7 +21,6 @@ async function getTranslator(config, params) {
         locale,
         hasKey: translator.hasKey,
         t: translator.t,
-        tRaw: translator.tRaw,
     };
 }
 

package/dist/core/src/server/intor/intor.js

@@ -5,8 +5,8 @@ import { createIntorRuntime } from '../runtime/create-intor-runtime.js';
 /**
  * Initializes Intor for the current execution context.
  *
- * Provides server-side bootstrap logic for SSR-based
- * full-stack frameworks.
+ * Produces a server-side snapshot for SSR and
+ * full-stack rendering environments.
  */
 async function intor(config, localeOrResolver, options) {
     const baseLogger = getLogger(config.logger);

package/dist/core/src/server/translator/create-translator.js

@@ -34,7 +34,6 @@ function createTranslator(params) {
         locale,
         hasKey: scoped ? scoped.hasKey : translator.hasKey,
         t: scoped ? scoped.t : translator.t,
-        tRaw: scoped ? scoped.tRaw : translator.tRaw,
     };
 }
 

package/dist/express/src/adapters/express/helpers/get-translator.js

@@ -16,6 +16,10 @@ async function getTranslator(config, req, params) {
         plugins,
         readers,
         allowCacheWrite,
+        // NOTE:
+        // The runtime implementation is intentionally erased.
+        // Type safety is guaranteed by public type contracts.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
     });
 }
 

package/dist/express/src/adapters/express/middleware/create-intor.js

@@ -15,7 +15,7 @@ import { getTranslator } from '../../../server/helpers/get-translator.js';
  *
  * The resolved routing state is exposed via response headers.
  *
- * - Acts as the bootstrap entry where cache writes are permitted.
+ * - Permits cache writes during server execution.
  * - Convenience routing shortcuts are also bound to the request for downstream consumption.
  *
  * @platform Express
@@ -43,20 +43,18 @@ function createIntor(config, options) {
         // --------------------------------------------------
         // Bind inbound routing context
         // --------------------------------------------------
-        const { hasKey, t, tRaw } = (await getTranslator(config, {
+        const { hasKey, t } = (await getTranslator(config, {
             locale,
             handlers: options?.handlers,
             plugins: options?.plugins,
             readers: options?.readers,
             allowCacheWrite: true,
         }));
-        req.intor = { locale, localeSource };
+        req.intor = { locale, localeSource, pathname };
         // DX shortcuts (optional)
         req.locale = locale;
-        req.localeSource = localeSource;
         req.hasKey = hasKey;
         req.t = t;
-        req.tRaw = tRaw;
         return next();
     };
 }

package/dist/express/src/routing/inbound/resolve-pathname/resolve-pathname.js

@@ -32,7 +32,7 @@ const resolvePathname = (config, rawPathname, context) => {
             return assertNever(localePrefix);
         }
     }
-    const { pathname } = localizePathname(config, rawPathname, context.locale);
+    const { pathname } = localizePathname(rawPathname, config, context.locale);
     return {
         pathname,
         shouldRedirect: directive.type === "redirect",

package/dist/{next/src/routing/pathname/get-unprefixed-pathname.js → express/src/routing/pathname/canonicalize-pathname.js}

@@ -10,11 +10,11 @@ import 'logry';
  * // config.supportedLocales: ["en-US"]
  * // config.routing.basePath: "/app"
  * // config.routing.prefix: "all"
- * getUnprefixedPathname(config, "/app/en-US/about" );
+ * canonicalizePathname("/app/en-US/about", config);
  * // => "/about"
  *```
  */
-function getUnprefixedPathname(config, rawPathname) {
+function canonicalizePathname(rawPathname, config) {
     const { routing, supportedLocales } = config;
     const { basePath } = routing;
     // 1. Normalize pathname
@@ -38,4 +38,4 @@ function getUnprefixedPathname(config, rawPathname) {
         : prefixedPathname;
 }
 
-export { getUnprefixedPathname };
+export { canonicalizePathname };

package/dist/express/src/routing/pathname/localize-pathname.js

@@ -1,5 +1,5 @@
-import { getUnprefixedPathname } from './get-unprefixed-pathname.js';
-import { localePrefixPathname } from './locale-prefix-pathname.js';
+import { canonicalizePathname } from './canonicalize-pathname.js';
+import { materializePathname } from './materialize-pathname.js';
 import { standardizePathname } from './standardize-pathname.js';
 
 /**
@@ -11,25 +11,25 @@ import { standardizePathname } from './standardize-pathname.js';
  * // config.supportedLocales: ["en-US"]
  * // config.routing.basePath: "/app"
  * // config.routing.prefix: "all"
- * localePrefixPathname({ config, pathname: "/app/en-US/about", locale: "en-US" });
+ * localizePathname(config, "/app/en-US/about", "en-US");
  * // => {
+ * //   pathname: '/app/en-US/about'
  * //   unprefixedPathname: '/about',
- * //   standardizedPathname: '/app/{locale}/about',
- * //   localizedPathname: '/app/en-US/about'
+ * //   templatedPathname: '/app/{locale}/about',
  * // }
  * ```
  */
-const localizePathname = (config, rawPathname, locale) => {
-    // 1. Canonicalize: extract basePath and strip locale
-    const unprefixedPathname = getUnprefixedPathname(config, rawPathname);
-    // 2. Standardize: build a pathname with locale placeholder
-    const standardizedPathname = standardizePathname(config, unprefixedPathname);
-    // 3. Apply strategy: resolve locale prefix based on routing rules
-    const pathname = localePrefixPathname(config, standardizedPathname, locale);
+const localizePathname = (rawPathname, config, locale) => {
+    // 1. Canonicalize: normalize and remove routing-specific prefixes
+    const canonicalized = canonicalizePathname(rawPathname, config);
+    // 2. Standardize: convert to internal pathname shape with locale placeholder
+    const standardized = standardizePathname(canonicalized, config);
+    // 3. Materialize: apply routing rules to produce the final pathname
+    const materialized = materializePathname(standardized, config, locale);
     return {
-        pathname,
-        unprefixedPathname,
-        standardizedPathname,
+        pathname: materialized,
+        unprefixedPathname: canonicalized,
+        templatedPathname: standardized,
     };
 };
 

package/dist/{core/src/routing/pathname/locale-prefix-pathname.js → express/src/routing/pathname/materialize-pathname.js}

@@ -4,20 +4,21 @@ import { normalizePathname } from '../../core/utils/normalizers/normalize-pathna
 import 'logry';
 
 /**
- * Applies the configured locale prefix behavior to a standardized pathname.
+ * Materializes a standardized pathname by applying
+ * the configured locale prefix behavior.
  *
  * @example
  * ```ts
  * // config.routing.localePrefix: "all"
- * localePrefixPathname({ config, pathname: "/app/{locale}/about", locale: "en-US" });
+ * materializePathname("/app/{locale}/about", config, "en-US");
  * // => /app/en-US/about
  *
  * // config.routing.localePrefix: "none"
- * localePrefixPathname({ config, pathname: "/app/{locale}/about", locale: "en-US" });
+ * materializePathname("/app/{locale}/about", config, "en-US");
  * // => /app/about
  * ```
  */
-const localePrefixPathname = (config, standardizedPathname, locale) => {
+const materializePathname = (standardizedPathname, config, locale) => {
     const { localePrefix } = config.routing;
     if (localePrefix !== "none" && !locale) {
         throw new Error('No locale when using localePrefix "all", "except-default"');
@@ -36,4 +37,4 @@ const localePrefixPathname = (config, standardizedPathname, locale) => {
     return normalizePathname(standardizedPathname.replaceAll(`/${PREFIX_PLACEHOLDER}`, ""));
 };
 
-export { localePrefixPathname };
+export { materializePathname };

package/dist/express/src/routing/pathname/standardize-pathname.js

@@ -4,24 +4,24 @@ import { normalizePathname } from '../../core/utils/normalizers/normalize-pathna
 import 'logry';
 
 /**
- * Standardizes a canonical pathname by applying the base path
- * and injecting the locale placeholder.
+ * Standardizes a canonical pathname into an internal routing template
+ * by applying the base path and injecting a locale placeholder.
  *
  * @example
  * ```ts
- * // routing.basePath: "/app",
- * standardizePathname({ config, pathname: "/cms" });
- * // => "/app/{locale}/cms"
+ * // config.routing.basePath: "/app",
+ * // config.routing.prefix: "all"
+ * standardizePathname("/about", config);
+ * // => "/app/{locale}/about"
  * ```
  */
-const standardizePathname = (config, unprefixedPathname) => {
-    const { routing } = config;
-    const { basePath } = routing;
+const standardizePathname = (canonicalizedPathname, config) => {
+    const { basePath } = config.routing;
     // Normalize each segment before join to avoid redundant slashes
     const parts = [
         normalizePathname(basePath),
         PREFIX_PLACEHOLDER,
-        normalizePathname(unprefixedPathname),
+        normalizePathname(canonicalizedPathname),
     ];
     // Avoid double slashes between segments
     const standardizedPathname = parts.join("/").replaceAll(/\/{2,}/g, "/");

package/dist/express/src/server/helpers/get-translator.js

@@ -21,7 +21,6 @@ async function getTranslator(config, params) {
         locale,
         hasKey: translator.hasKey,
         t: translator.t,
-        tRaw: translator.tRaw,
     };
 }
 

package/dist/express/src/server/translator/create-translator.js

@@ -34,7 +34,6 @@ function createTranslator(params) {
         locale,
         hasKey: scoped ? scoped.hasKey : translator.hasKey,
         t: scoped ? scoped.t : translator.t,
-        tRaw: scoped ? scoped.tRaw : translator.tRaw,
     };
 }
 

package/dist/next/src/adapters/next/navigation/use-pathname.js

@@ -9,17 +9,17 @@ import { localizePathname } from '../../../routing/pathname/localize-pathname.js
  *
  * @example
  * ```ts
- * const { pathname, standardizedPathname, unprefixedPathname } = usePathname();
- * // pathname => "/en-US/about"
- * // standardizedPathname => "/{locale}/about"
+ * const { pathname, unprefixedPathname, templatedPathname } = usePathname();
+ * // pathname => "/app/en-US/about"
  * // unprefixedPathname => "/about"
+ * // templatedPathname => "/app/{locale}/about"
  * ```
  * @platform Next.js
  */
 const usePathname = () => {
     const { config, locale } = useIntor();
     const rawPathname = usePathname$1();
-    return localizePathname(config, rawPathname, locale);
+    return localizePathname(rawPathname, config, locale);
 };
 
 export { usePathname };

package/dist/next/src/adapters/next/proxy/intor-proxy.js

@@ -11,7 +11,7 @@ import { getLocaleFromAcceptLanguage } from '../../../routing/locale/get-locale-
  *
  * The resolved routing state is exposed via response headers.
  *
- * -  Acts as the canonical routing authority, guaranteeing a canonical routing result for every request.
+ * - Acts as the canonical routing authority, guaranteeing a canonical routing result for every request.
  *
  * @platform Next.js
  */

package/dist/next/src/adapters/next/server/get-pathname.js

@@ -9,10 +9,10 @@ import { localizePathname } from '../../../routing/pathname/localize-pathname.js
  *
  * @example
  * ```ts
- * const { pathname, standardizedPathname, unprefixedPathname } = usePathname();
- * // pathname => "/en-US/about"
- * // standardizedPathname => "/{locale}/about"
+ * const { pathname, unprefixedPathname, templatedPathname } = await getPathname();
+ * // pathname => "/app/en-US/about"
  * // unprefixedPathname => "/about"
+ * // templatedPathname => "/app/{locale}/about"
  * ```
  * @note Requires inbound routing context; otherwise the result may be inferred.
  * @platform Next.js
@@ -21,7 +21,7 @@ async function getPathname(config) {
     const headersStore = await headers();
     const locale = headersStore.get(INTOR_HEADERS.LOCALE) || config.defaultLocale;
     const rawPathname = headersStore.get(INTOR_HEADERS.PATHNAME) || "/";
-    return localizePathname(config, rawPathname, locale);
+    return localizePathname(rawPathname, config, locale);
 }
 
 export { getPathname };

package/dist/next/src/adapters/next/server/get-translator.js

@@ -17,6 +17,10 @@ async function getTranslator(config, params) {
         plugins,
         readers,
         allowCacheWrite,
+        // NOTE:
+        // The runtime implementation is intentionally erased.
+        // Type safety is guaranteed by public type contracts.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
     });
 }
 

package/dist/next/src/adapters/next/server/intor.js

@@ -11,7 +11,7 @@ import { getLocale } from './get-locale.js';
  * Initializes Intor for the current execution context.
  *
  * - Automatically resolves the locale from the framework context.
- * - Acts as the bootstrap entry where cache writes are permitted.
+ * - Permits cache writes during server execution.
  * @platform Next.js
  */
 async function intor(config, readers) {

package/dist/next/src/routing/inbound/resolve-pathname/resolve-pathname.js

@@ -32,7 +32,7 @@ const resolvePathname = (config, rawPathname, context) => {
             return assertNever(localePrefix);
         }
     }
-    const { pathname } = localizePathname(config, rawPathname, context.locale);
+    const { pathname } = localizePathname(rawPathname, config, context.locale);
     return {
         pathname,
         shouldRedirect: directive.type === "redirect",

package/dist/next/src/routing/navigation/derive-target.js

@@ -1,4 +1,4 @@
-import { getUnprefixedPathname } from '../pathname/get-unprefixed-pathname.js';
+import { canonicalizePathname } from '../pathname/canonicalize-pathname.js';
 import { localizePathname } from '../pathname/localize-pathname.js';
 import { deriveHostDestination } from './utils/derive-host-destination.js';
 import { deriveQueryDestination } from './utils/derive-query-destination.js';
@@ -23,7 +23,7 @@ function deriveTarget(config, currentLocale, currentPathname, intent) {
     // ----------------------------------------------------------------
     // Use the unprefixed logical path as the navigation base.
     // Locale prefixes are applied later by inbound canonicalization.
-    const rawDestination = intent?.destination ?? getUnprefixedPathname(config, currentPathname);
+    const rawDestination = intent?.destination ?? canonicalizePathname(currentPathname, config);
     const isExternal = isExternalDestination(rawDestination);
     // ----------------------------------------------------------------
     // Project destination by navigation carrier
@@ -32,15 +32,15 @@ function deriveTarget(config, currentLocale, currentPathname, intent) {
     if (!isExternal) {
         switch (routing.outbound.localeCarrier) {
             case "path": {
-                destination = localizePathname(config, rawDestination, locale).pathname;
+                destination = localizePathname(rawDestination, config, locale).pathname;
                 break;
             }
             case "host": {
-                destination = deriveHostDestination(config, rawDestination, locale);
+                destination = deriveHostDestination(rawDestination, config, locale);
                 break;
             }
             case "query": {
-                destination = deriveQueryDestination(config, rawDestination, locale);
+                destination = deriveQueryDestination(rawDestination, config, locale);
                 break;
             }
             default: {

package/dist/next/src/routing/navigation/utils/derive-host-destination.js

@@ -1,7 +1,7 @@
 /**
  * Derives a locale-specific destination using host-based navigation.
  */
-const deriveHostDestination = (config, rawDestination, locale) => {
+const deriveHostDestination = (rawDestination, config, locale) => {
     const { host } = config.routing.outbound;
     const resolvedHost = host.map[locale] ?? host.default;
     if (!resolvedHost)

package/dist/next/src/routing/navigation/utils/derive-query-destination.js

@@ -1,7 +1,7 @@
 /**
  *  Derives a locale-specific destination using query-based navigation.
  */
-const deriveQueryDestination = (config, rawDestination, locale) => {
+const deriveQueryDestination = (rawDestination, config, locale) => {
     const { queryKey } = config.routing.outbound;
     const url = new URL(rawDestination, "http://internal");
     url.searchParams.set(queryKey, locale);

package/dist/{express/src/routing/pathname/get-unprefixed-pathname.js → next/src/routing/pathname/canonicalize-pathname.js}

@@ -10,11 +10,11 @@ import 'logry';
  * // config.supportedLocales: ["en-US"]
  * // config.routing.basePath: "/app"
  * // config.routing.prefix: "all"
- * getUnprefixedPathname(config, "/app/en-US/about" );
+ * canonicalizePathname("/app/en-US/about", config);
  * // => "/about"
  *```
  */
-function getUnprefixedPathname(config, rawPathname) {
+function canonicalizePathname(rawPathname, config) {
     const { routing, supportedLocales } = config;
     const { basePath } = routing;
     // 1. Normalize pathname
@@ -38,4 +38,4 @@ function getUnprefixedPathname(config, rawPathname) {
         : prefixedPathname;
 }
 
-export { getUnprefixedPathname };
+export { canonicalizePathname };

package/dist/next/src/routing/pathname/localize-pathname.js

@@ -1,5 +1,5 @@
-import { getUnprefixedPathname } from './get-unprefixed-pathname.js';
-import { localePrefixPathname } from './locale-prefix-pathname.js';
+import { canonicalizePathname } from './canonicalize-pathname.js';
+import { materializePathname } from './materialize-pathname.js';
 import { standardizePathname } from './standardize-pathname.js';
 
 /**
@@ -11,25 +11,25 @@ import { standardizePathname } from './standardize-pathname.js';
  * // config.supportedLocales: ["en-US"]
  * // config.routing.basePath: "/app"
  * // config.routing.prefix: "all"
- * localePrefixPathname({ config, pathname: "/app/en-US/about", locale: "en-US" });
+ * localizePathname(config, "/app/en-US/about", "en-US");
  * // => {
+ * //   pathname: '/app/en-US/about'
  * //   unprefixedPathname: '/about',
- * //   standardizedPathname: '/app/{locale}/about',
- * //   localizedPathname: '/app/en-US/about'
+ * //   templatedPathname: '/app/{locale}/about',
  * // }
  * ```
  */
-const localizePathname = (config, rawPathname, locale) => {
-    // 1. Canonicalize: extract basePath and strip locale
-    const unprefixedPathname = getUnprefixedPathname(config, rawPathname);
-    // 2. Standardize: build a pathname with locale placeholder
-    const standardizedPathname = standardizePathname(config, unprefixedPathname);
-    // 3. Apply strategy: resolve locale prefix based on routing rules
-    const pathname = localePrefixPathname(config, standardizedPathname, locale);
+const localizePathname = (rawPathname, config, locale) => {
+    // 1. Canonicalize: normalize and remove routing-specific prefixes
+    const canonicalized = canonicalizePathname(rawPathname, config);
+    // 2. Standardize: convert to internal pathname shape with locale placeholder
+    const standardized = standardizePathname(canonicalized, config);
+    // 3. Materialize: apply routing rules to produce the final pathname
+    const materialized = materializePathname(standardized, config, locale);
     return {
-        pathname,
-        unprefixedPathname,
-        standardizedPathname,
+        pathname: materialized,
+        unprefixedPathname: canonicalized,
+        templatedPathname: standardized,
     };
 };
 

package/dist/{react/src/routing/pathname/locale-prefix-pathname.js → next/src/routing/pathname/materialize-pathname.js}

@@ -4,20 +4,21 @@ import { normalizePathname } from '../../core/utils/normalizers/normalize-pathna
 import 'logry';
 
 /**
- * Applies the configured locale prefix behavior to a standardized pathname.
+ * Materializes a standardized pathname by applying
+ * the configured locale prefix behavior.
  *
  * @example
  * ```ts
  * // config.routing.localePrefix: "all"
- * localePrefixPathname({ config, pathname: "/app/{locale}/about", locale: "en-US" });
+ * materializePathname("/app/{locale}/about", config, "en-US");
  * // => /app/en-US/about
  *
  * // config.routing.localePrefix: "none"
- * localePrefixPathname({ config, pathname: "/app/{locale}/about", locale: "en-US" });
+ * materializePathname("/app/{locale}/about", config, "en-US");
  * // => /app/about
  * ```
  */
-const localePrefixPathname = (config, standardizedPathname, locale) => {
+const materializePathname = (standardizedPathname, config, locale) => {
     const { localePrefix } = config.routing;
     if (localePrefix !== "none" && !locale) {
         throw new Error('No locale when using localePrefix "all", "except-default"');
@@ -36,4 +37,4 @@ const localePrefixPathname = (config, standardizedPathname, locale) => {
     return normalizePathname(standardizedPathname.replaceAll(`/${PREFIX_PLACEHOLDER}`, ""));
 };
 
-export { localePrefixPathname };
+export { materializePathname };