What's new in astro-intl

Isolated SSR locale and message state with Node.js AsyncLocalStorage; unsupported SSR runtimes now fail explicitly instead of sharing process-global request data.

Replaced regex-only HTML filtering with parser-based allowlist sanitization for t.markup().

Escaped and sanitized Svelte rich-text rendering and rejected unsafe native tag mappings.

Validated locale path segments before routing and browser redirect construction.

Escaped JSON-LD script content and safely rendered the documentation changelog.

Clean publication builds now exclude tests, copy AutoRedirect.astro, validate exports and reject unexpected tarball files.

Vitest discovers source tests only and no longer re-runs compiled tests from dist.

Updated current React and request-locale examples while preserving historical signatures in the v1→v2 migration guide.

Added official Astro 7 support by extending the peer range to ^4 || ^5 || ^6 || ^7, while preserving Astro 4–6 compatibility and all current public APIs.

Updated the playground canary to Astro 7.0.9, @astrojs/vercel 11.0.3 and @astrojs/sitemap 3.7.3.

Extended the tarball compatibility matrix to Astro 4.16.19, 5.18.2, 6.4.8 and 7.0.9.

Validated Astro 7 with Vite 8/Rolldown, the Rust .astro compiler, queued nested rendering, Advanced Routing in full and explicitly composed pipelines, and locale-separated route caching.

Documented that Astro 7 requires Node.js 22.12.0 or newer without changing astro-intl's Node.js requirement for Astro 4–6 consumers.

Republished 2.2.0 with the package version updated to 2.2.1. The public tarballs contain identical compiled code.

t.raw() function — access raw translation values (arrays, objects, numbers) without string coercion. Use t.raw("key") to get the native value type instead of [object Object].

messagesDir integration option — simplified API for loading JSON files. Set messagesDir: "./src/i18n/messages" and the integration will automatically load {locale}.json files with the correct import attributes.

Auto-detection of locale in static mode — getLocale() now automatically detects the locale from window.location.pathname when setRequestLocale() hasn't been called (client-side only).

<AutoRedirect /> component — new Astro component export from astro-intl/components. Detects browser language and redirects to the appropriate localized route without the blank page issue of Astro.redirect(). Supports locales and defaultLocale props.

MessagesDirConfig type — exported type for the messagesDir configuration option.

Updated package.json exports to include ./components sub-path for the AutoRedirect component.

Improved error messages when request config is not found.

Astro v6 support — peerDependencies now accepts ^4 || ^5 || ^6. Backward compatible with Astro 4 and 5.

getFallbackRoutes() API — new public function that returns i18n fallback routes collected from Astro 6.1's astro:routes:resolved hook. Returns an empty array on Astro < 6.1.

FallbackRouteInfo type — exported type with { pattern: string; pathname?: string; locale: string }.

astro:routes:resolved hook — the integration now listens to this hook to automatically detect and store fallback routes when i18n.fallbackType: 'rewrite' is configured in Astro.

devDependencies.astro updated to ^6.1.0.

@astrojs/vercel updated to ^10.0.3 in docs projects (Astro 6 compatible).

happy-dom updated to ^20.8.9 to fix CVE-2026-33943 (RCE via ECMAScriptModuleCompiler).

Resolved all 32 Dependabot vulnerability alerts, including:

getTranslationsReact removed from root export — React support is now imported from astro-intl/react instead of astro-intl.

Sub-path imports required for framework adapters — use astro-intl/react and astro-intl/svelte instead of importing from the root.

Old src/react.ts deleted — logic migrated to src/adapters/react.ts.

Svelte adapter — getTranslations and createGetTranslations with t.rich() returning RichSegment[]. Import from astro-intl/svelte.

renderRichText() helper — resolves RichSegment[] into an HTML string using tags (native HTML elements) and components (custom functions). Import from astro-intl/svelte.

RichSegment type — framework-agnostic segment type (text | tag) exported from astro-intl/svelte.

createGetTranslations factory — standalone translation factory (no store dependency) available in both React and Svelte adapters.

Framework-agnostic base — parseRichSegments() in src/framework-base.ts powers both React and Svelte rich text parsing.

New sub-path exports — astro-intl/react and astro-intl/svelte in package.json exports.

svelte@^5 added as optional peer dependency.

React adapter moved from src/react.ts to src/adapters/react.ts.

React t.rich() now uses the shared parseRichSegments() base with recursive nested tag support.

Package structure reorganized with src/adapters/ directory for framework-specific code.

Localized routing system — define translated URL paths per locale (e.g. /es/sobre-nosotros instead of /es/about).

path(routeKey, options?) — generate localized URLs for named routes with dynamic [param] substitution. Import from astro-intl/routing.

switchLocalePath(currentPath, nextLocale) — convert the current URL to its equivalent in another locale, preserving params, query strings and hashes. Import from astro-intl/routing.

routes option in createIntlMiddleware — the middleware automatically rewrites translated URLs to their canonical filesystem paths (no duplicate page files needed).

routes option in integration config (astro.config.mjs) — for projects that don't use middleware.

RoutesMap type exported from astro-intl/types.

Route template validation — detects unbalanced brackets and invalid param names at build time.

Route conflict detection — throws on duplicate templates and warns on structurally equivalent ones.

createIntlMiddleware signature now accepts routes?: RoutesMap in options.

New ./routing export path in package.json for astro-intl/routing.

createIntlMiddleware() now automatically sets locales and defaultLocale in the intl store via __setIntlConfig. Users who use middleware no longer need to pass these options to intl() in astro.config.mjs.

defaultLocale option in IntlMiddlewareOptions type.

Configurable defaultLocale option — no more hardcoded "en" fallback.

runWithLocale() — concurrency-safe request context via AsyncLocalStorage.

Multi-runtime support — auto-detects AsyncLocalStorage (Node.js) with global-variable fallback (Cloudflare Workers, Deno).

IntlConfig type exported for integration configuration.

Modular architecture — core.ts split into sanitize, interpolation, store, translations modules.

react.ts now imports shared escapeRegExp from sanitize.ts (removed duplicate).

Race condition in SSR — concurrent requests no longer share state.

Hardcoded "en" fallback locale now respects defaultLocale config.

Variable interpolation with t("key", { name: "value" }).

t.markup() for HTML in translations with security sanitisation.

t.rich() for React with nested tag support.

defineRequestConfig() for global config registration (next-intl style).

Messages via integration options (messages config).

BCP-47 locale validation.

Prototype-pollution protection in dot-path traversal.

HTML sanitisation (defence-in-depth) in t.markup().

Initial release.

setRequestLocale() for URL-based locale detection.

getLocale() to read current locale.

getTranslations() with namespace support.

getTranslationsReact() for React components.

Type-safety with DotPaths<T>.

Native Astro integration.