@ultimat3/i18n 22.2.2 → 22.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/i18n",
-  "version": "22.2.2",
+  "version": "22.3.0",
   "description": "Dependency-free translator, catalog flattening, locale negotiation and loud missing-key rendering",
   "license": "MIT",
   "type": "module",
@@ -35,6 +35,6 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "22.2.2"
+    "@ultimat3/core": "22.3.0"
   }
 }

package/src/context.ts

@@ -102,6 +102,24 @@ export function configureLocales(partial: Partial<LocaleConfig>): LocaleConfig {
   return config;
 }
 
+const isShippedSet = (supported: readonly Locale[]): boolean =>
+  supported.length === SUPPORTED_LOCALES.length &&
+  supported.every((locale, index) => locale === SUPPORTED_LOCALES[index]);
+
+/**
+ * The locales a URL may name, the default first: the app's declared set, or the fallback alone
+ * when it declared none. What prefix routing, the per-locale prerender, hreflang
+ * and the sitemap all enumerate — one list, so none of them can name a page another never made.
+ */
+export function routedLocales(): readonly Locale[] {
+  // The shipped `supported` set is the thirty tags the framework can NEGOTIATE, not the ones an app
+  // translated: routing it would publish thirty copies of an English-only site. Compared by value,
+  // never tracked by a flag — `@ultimat3/testing`'s snapshot restores the config through
+  // `configureLocales`, and a flag set by that call would read the defaults as a declaration.
+  if (isShippedSet(config.supported)) return [config.fallback];
+  return [config.fallback, ...config.supported.filter((locale) => locale !== config.fallback)];
+}
+
 export function localeConfig(): LocaleConfig {
   return config;
 }

package/src/index.ts

@@ -36,6 +36,7 @@ export {
   resetCatalogs,
   resetLocaleConfig,
   resolveLocale,
+  routedLocales,
   t,
   translatorFor,
   useI18n,
@@ -83,6 +84,13 @@ export {
   pluralVariantsOf,
   selectPluralKey,
 } from './interpolate';
+export {
+  type LocalePrefix,
+  localeSegment,
+  localizedPath,
+  splitLocalePrefix,
+  unlocalizedPath,
+} from './locale-path';
 export {
   assertSupportedLocale,
   DEFAULT_LOCALE,

package/src/locale-path.ts

@@ -0,0 +1,37 @@
+/**
+ * A locale in the URL, against the APP's configured locales: how a leading `/<locale>/` segment is
+ * split off a pathname, and how a path is spelled in a locale. The arithmetic is core's
+ * (`locale-path.ts`, tier 0 so a browser chunk can spell a link without this barrel); this file
+ * supplies the routed locales and the default, so `@ultimat3/http` routes, `@ultimat3/render` hands
+ * `meta` and the prerender writes files from one answer.
+ */
+
+import { type LocalePathSplit, localeSegment, localizePath, splitLocalePath } from '@ultimat3/core';
+import { localeConfig, routedLocales } from './context';
+import type { Locale } from './locales';
+
+export { localeSegment };
+export type LocalePrefix = LocalePathSplit;
+
+/** `/en/precios` → `{ locale: 'en', path: '/precios', isDefault: false }`, or `undefined`. */
+export function splitLocalePrefix(
+  pathname: string,
+  locales: readonly Locale[] = routedLocales(),
+  fallback: Locale = localeConfig().fallback,
+): LocalePrefix | undefined {
+  return splitLocalePath(pathname, locales, fallback);
+}
+
+/** `path` as `locale` spells it — unprefixed for the default locale, `/en/…` otherwise. */
+export function localizedPath(
+  path: string,
+  locale: Locale,
+  fallback: Locale = localeConfig().fallback,
+): string {
+  return localizePath(path, locale, routedLocales(), fallback);
+}
+
+/** The pathname with any routed locale prefix removed — the path the route table matches. */
+export function unlocalizedPath(pathname: string): string {
+  return splitLocalePrefix(pathname)?.path ?? pathname;
+}