@quilted/preact-localize 0.0.0-preview-20240627021955

package/CHANGELOG.md

@@ -0,0 +1,222 @@
+# @quilted/react-localize
+
+## 0.0.0-preview-20240627021955
+
+### Patch Changes
+
+- Simplify routing library
+
+- Updated dependencies []:
+  - @quilted/request-router@0.0.0-preview-20240627021955
+  - @quilted/preact-router@0.0.0-preview-20240627021955
+
+## 1.0.0
+
+### Patch Changes
+
+- [#757](https://github.com/lemonmade/quilt/pull/757) [`00cac4b`](https://github.com/lemonmade/quilt/commit/00cac4b4d01831ba654e94152d7a67a0ef75043b) Thanks [@lemonmade](https://github.com/lemonmade)! - Simplify routing library
+
+- Updated dependencies [[`00cac4b`](https://github.com/lemonmade/quilt/commit/00cac4b4d01831ba654e94152d7a67a0ef75043b)]:
+  - @quilted/request-router@0.3.0
+  - @quilted/preact-router@0.2.0
+
+## 0.2.2
+
+### Patch Changes
+
+- [#716](https://github.com/lemonmade/quilt/pull/716) [`7daafca`](https://github.com/lemonmade/quilt/commit/7daafca900b3d9ea66be179394eadf7998cc94be) Thanks [@lemonmade](https://github.com/lemonmade)! - Refactor browser APIs
+
+- Updated dependencies [[`7daafca`](https://github.com/lemonmade/quilt/commit/7daafca900b3d9ea66be179394eadf7998cc94be)]:
+  - @quilted/react-browser@0.0.1
+  - @quilted/react-router@0.4.1
+
+## 0.2.1
+
+### Patch Changes
+
+- [`905e92ef`](https://github.com/lemonmade/quilt/commit/905e92ef32adad8658042f437b9cfbd248cce3c3) Thanks [@lemonmade](https://github.com/lemonmade)! - Simplify React exports
+
+## 0.2.0
+
+### Minor Changes
+
+- [#645](https://github.com/lemonmade/quilt/pull/645) [`302ed847`](https://github.com/lemonmade/quilt/commit/302ed8479f9c035ef39d48137de958dba50690ca) Thanks [@lemonmade](https://github.com/lemonmade)! - Removed CommonJS support
+
+  The `require` export condition is no longer provided by any package. Quilt only supports ESModules, so if you need to use the CommonJS version, you will need to pre-process Quilt’s output code on your own.
+
+### Patch Changes
+
+- Updated dependencies [[`302ed847`](https://github.com/lemonmade/quilt/commit/302ed8479f9c035ef39d48137de958dba50690ca)]:
+  - @quilted/useful-react-types@2.0.0
+  - @quilted/localize@0.2.0
+  - @quilted/react-html@0.4.0
+  - @quilted/react-http@0.4.0
+  - @quilted/react-router@0.4.0
+  - @quilted/react-utilities@0.2.0
+  - @quilted/request-router@0.2.0
+
+## 0.1.19
+
+### Patch Changes
+
+- [#612](https://github.com/lemonmade/quilt/pull/612) [`bc849bc7`](https://github.com/lemonmade/quilt/commit/bc849bc740318936656162fde851b784ed6ef78f) Thanks [@lemonmade](https://github.com/lemonmade)! - Simplify app template APIs
+
+- Updated dependencies [[`bc849bc7`](https://github.com/lemonmade/quilt/commit/bc849bc740318936656162fde851b784ed6ef78f)]:
+  - @quilted/react-http@0.3.31
+  - @quilted/request-router@0.1.8
+
+## 0.1.18
+
+### Patch Changes
+
+- Updated dependencies [[`9122cbbc`](https://github.com/lemonmade/quilt/commit/9122cbbce965bf5b432027e0707b2d619857fa67)]:
+  - @quilted/useful-react-types@1.0.0
+
+## 0.1.17
+
+### Patch Changes
+
+- [`6e999a5f`](https://github.com/lemonmade/quilt/commit/6e999a5f2b3001923fdb83d9954318742e3a84e3) Thanks [@lemonmade](https://github.com/lemonmade)! - Add basic translation function
+
+## 0.1.16
+
+### Patch Changes
+
+- [`7a431339`](https://github.com/lemonmade/quilt/commit/7a4313390827aefdbbf9b28f2a5aa6213d6b33f5) Thanks [@lemonmade](https://github.com/lemonmade)! - Add automatic `dir` property in Automatically add `dir` HTML attribute
+
+## 0.1.15
+
+### Patch Changes
+
+- [`97812120`](https://github.com/lemonmade/quilt/commit/978121207c65a4450a8ca9e43d017c6425a315c3) Thanks [@lemonmade](https://github.com/lemonmade)! - Update Preact dependencies and fix some missing peer dependencies
+
+- Updated dependencies [[`1a22a1c5`](https://github.com/lemonmade/quilt/commit/1a22a1c572c3d37d2564eb9eb908904a6d254201), [`97812120`](https://github.com/lemonmade/quilt/commit/978121207c65a4450a8ca9e43d017c6425a315c3)]:
+  - @quilted/request-router@0.1.5
+  - @quilted/react-http@0.3.29
+
+## 0.1.14
+
+### Patch Changes
+
+- [#536](https://github.com/lemonmade/quilt/pull/536) [`cf6e2de1`](https://github.com/lemonmade/quilt/commit/cf6e2de186d8644fad9afcedda85c05002e909e1) Thanks [@lemonmade](https://github.com/lemonmade)! - Update to TypeScript 5.0
+
+- Updated dependencies [[`cf6e2de1`](https://github.com/lemonmade/quilt/commit/cf6e2de186d8644fad9afcedda85c05002e909e1)]:
+  - @quilted/react-http@0.3.28
+  - @quilted/request-router@0.1.4
+
+## 0.1.13
+
+### Patch Changes
+
+- [`8f1d275b`](https://github.com/lemonmade/quilt/commit/8f1d275b6de0abbc6f61bcd5401555f6480eb474) Thanks [@lemonmade](https://github.com/lemonmade)! - Remove need for @babel/runtime peer dependency
+
+- Updated dependencies [[`8f1d275b`](https://github.com/lemonmade/quilt/commit/8f1d275b6de0abbc6f61bcd5401555f6480eb474), [`50215b7c`](https://github.com/lemonmade/quilt/commit/50215b7c005c21440bca04935fda87d98d9d9d01)]:
+  - @quilted/react-http@0.3.27
+  - @quilted/request-router@0.1.3
+
+## 0.1.12
+
+### Patch Changes
+
+- [#474](https://github.com/lemonmade/quilt/pull/474) [`8890fad8`](https://github.com/lemonmade/quilt/commit/8890fad8d04efa95b362f4beaefcdbd51e65ba04) Thanks [@lemonmade](https://github.com/lemonmade)! - Looser React version restrictions
+
+- Updated dependencies [[`e647289c`](https://github.com/lemonmade/quilt/commit/e647289c14a2bf8d0d9d322cd3fe1be3f675c535), [`8890fad8`](https://github.com/lemonmade/quilt/commit/8890fad8d04efa95b362f4beaefcdbd51e65ba04)]:
+  - @quilted/react-http@0.3.25
+
+## 0.1.11
+
+### Patch Changes
+
+- [`a011fa25`](https://github.com/lemonmade/quilt/commit/a011fa25808818ed4e5651a25f267becc327ef2d) Thanks [@lemonmade](https://github.com/lemonmade)! - Fix Localization `lang` attribute on client
+
+## 0.1.10
+
+### Patch Changes
+
+- [#447](https://github.com/lemonmade/quilt/pull/447) [`6ad741b2`](https://github.com/lemonmade/quilt/commit/6ad741b241027c8d7612e206497935ad938ea6c9) Thanks [@lemonmade](https://github.com/lemonmade)! - Simplify app templates
+
+## 0.1.9
+
+### Patch Changes
+
+- [#436](https://github.com/lemonmade/quilt/pull/436) [`3171fcee`](https://github.com/lemonmade/quilt/commit/3171fceeddfb14c253ac45e34e1e2f9ab6e3f6c0) Thanks [@lemonmade](https://github.com/lemonmade)! - Rename http-handlers to request-router
+
+- Updated dependencies [[`3171fcee`](https://github.com/lemonmade/quilt/commit/3171fceeddfb14c253ac45e34e1e2f9ab6e3f6c0)]:
+  - @quilted/request-router@0.1.1
+
+## 0.1.8
+
+### Patch Changes
+
+- [`51482122`](https://github.com/lemonmade/quilt/commit/514821223b4d8eb9c5289265c7cd2b4ef0b2e8b3) Thanks [@lemonmade](https://github.com/lemonmade)! - Add a utility for creating optional context
+
+## 0.1.7
+
+### Patch Changes
+
+- [`a12c3576`](https://github.com/lemonmade/quilt/commit/a12c357693b173461f51a35fb7efdd0a9267e471) Thanks [@lemonmade](https://github.com/lemonmade)! - Fix more build issues
+
+- Updated dependencies [[`a12c3576`](https://github.com/lemonmade/quilt/commit/a12c357693b173461f51a35fb7efdd0a9267e471)]:
+  - @quilted/http-handlers@0.2.43
+  - @quilted/react-http@0.3.23
+
+## 0.1.6
+
+### Patch Changes
+
+- [`0629288e`](https://github.com/lemonmade/quilt/commit/0629288ee4ba2e2ccfd73fbb216c3559e1a5c77e) Thanks [@lemonmade](https://github.com/lemonmade)! - Fix missing package builds
+
+- Updated dependencies [[`0629288e`](https://github.com/lemonmade/quilt/commit/0629288ee4ba2e2ccfd73fbb216c3559e1a5c77e)]:
+  - @quilted/http-handlers@0.2.42
+  - @quilted/react-http@0.3.22
+
+## 0.1.5
+
+### Patch Changes
+
+- [#364](https://github.com/lemonmade/quilt/pull/364) [`4dc1808a`](https://github.com/lemonmade/quilt/commit/4dc1808a86d15e821b218b528617430cbd8b5b48) Thanks [@lemonmade](https://github.com/lemonmade)! - Update to simplified Quilt config
+
+- Updated dependencies [[`4dc1808a`](https://github.com/lemonmade/quilt/commit/4dc1808a86d15e821b218b528617430cbd8b5b48)]:
+  - @quilted/http-handlers@0.2.41
+  - @quilted/react-http@0.3.21
+
+## 0.1.4
+
+### Patch Changes
+
+- [#359](https://github.com/lemonmade/quilt/pull/359) [`2eceac54`](https://github.com/lemonmade/quilt/commit/2eceac546fa3ee3e2c4d2887ab4a6a021acb52cd) Thanks [@lemonmade](https://github.com/lemonmade)! - Update TypeScript and ESLint to latest versions
+
+* [#361](https://github.com/lemonmade/quilt/pull/361) [`47065859`](https://github.com/lemonmade/quilt/commit/47065859c330e2da23d8758fb165ae84a4f1af4f) Thanks [@lemonmade](https://github.com/lemonmade)! - Move to native Request and Response objects
+
+* Updated dependencies [[`2eceac54`](https://github.com/lemonmade/quilt/commit/2eceac546fa3ee3e2c4d2887ab4a6a021acb52cd), [`47065859`](https://github.com/lemonmade/quilt/commit/47065859c330e2da23d8758fb165ae84a4f1af4f)]:
+  - @quilted/http-handlers@0.2.38
+  - @quilted/react-http@0.3.20
+
+## 0.1.3
+
+### Patch Changes
+
+- [`ddaa8197`](https://github.com/lemonmade/quilt/commit/ddaa8197c5576d5c29b90bfc7752596df56c97b1) Thanks [@lemonmade](https://github.com/lemonmade)! - Improve localization fallback behavior
+
+## 0.1.2
+
+### Patch Changes
+
+- [#269](https://github.com/lemonmade/quilt/pull/269) [`c78a1e13`](https://github.com/lemonmade/quilt/commit/c78a1e1365807e072cda4fece55d53712210cad4) Thanks [@lemonmade](https://github.com/lemonmade)! - Add localized routing
+
+## 0.1.1
+
+### Patch Changes
+
+- [#263](https://github.com/lemonmade/quilt/pull/263) [`6df853eb`](https://github.com/lemonmade/quilt/commit/6df853eb1e83abfa00e88b43e91b350da28d2704) Thanks [@lemonmade](https://github.com/lemonmade)! - Rename locale from environment hook
+
+## 0.1.0
+
+### Minor Changes
+
+- [`b0040c72`](https://github.com/lemonmade/quilt/commit/b0040c7279931f426df5d7fac91a3a35ea49eae1) Thanks [@lemonmade](https://github.com/lemonmade)! - Initial localization packages
+
+### Patch Changes
+
+- Updated dependencies [[`b0040c72`](https://github.com/lemonmade/quilt/commit/b0040c7279931f426df5d7fac91a3a35ea49eae1)]:
+  - @quilted/localize@0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019-present, Chris Sauvé and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/build/esm/Localization.mjs

@@ -0,0 +1,26 @@
+import { useMemo } from 'preact/hooks';
+import { createLocalizedFormatting } from '@quilted/localize';
+import { HTMLAttributes } from '@quilted/preact-browser';
+import { LocaleContext, LocalizedFormattingContext } from './context.mjs';
+import { jsx, jsxs } from 'preact/jsx-runtime';
+
+const RTL_LOCALES = new Set(['ar', 'arc', 'ckb', 'dv', 'fa', 'ha', 'he', 'khw', 'ks', 'ps', 'sd', 'ur', 'uz-AF', 'yi']);
+function Localization({
+  locale,
+  direction = RTL_LOCALES.has(locale) ? 'rtl' : 'ltr',
+  children
+}) {
+  const formatting = useMemo(() => createLocalizedFormatting(locale), [locale]);
+  return jsx(LocaleContext.Provider, {
+    value: locale,
+    children: jsxs(LocalizedFormattingContext.Provider, {
+      value: formatting,
+      children: [jsx(HTMLAttributes, {
+        lang: locale,
+        dir: direction
+      }), children]
+    })
+  });
+}
+
+export { Localization };

package/build/esm/context.mjs

@@ -0,0 +1,6 @@
+import { createOptionalContext } from '@quilted/preact-context';
+
+const LocalizedFormattingContext = createOptionalContext();
+const LocaleContext = createOptionalContext();
+
+export { LocaleContext, LocalizedFormattingContext };

package/build/esm/hooks/formatting.mjs

@@ -0,0 +1,5 @@
+import { LocalizedFormattingContext } from '../context.mjs';
+
+const useLocalizedFormatting = LocalizedFormattingContext.use;
+
+export { useLocalizedFormatting };

package/build/esm/hooks/locale-from-environment.mjs

@@ -0,0 +1,15 @@
+import { parseAcceptLanguageHeader } from '@quilted/localize';
+import { useBrowserDetails } from '@quilted/preact-browser';
+
+function useLocaleFromEnvironment() {
+  if (typeof navigator === 'object' && navigator.language) {
+    return navigator.language;
+  }
+  const browserDetails = useBrowserDetails({
+    optional: true
+  });
+  const acceptLanguage = browserDetails?.request.headers?.get('Accept-Language');
+  return acceptLanguage && parseAcceptLanguageHeader(acceptLanguage);
+}
+
+export { useLocaleFromEnvironment };

package/build/esm/hooks/locale.mjs

@@ -0,0 +1,5 @@
+import { LocaleContext } from '../context.mjs';
+
+const useLocale = LocaleContext.use;
+
+export { useLocale };

package/build/esm/index.mjs

@@ -0,0 +1,13 @@
+export { MissingTranslationError, MissingTranslationPlaceholderError, createLocalizedFormatting, createTranslate, parseAcceptLanguageHeader } from '@quilted/localize';
+export { Localization } from './Localization.mjs';
+export { useLocalizedFormatting } from './hooks/formatting.mjs';
+export { useLocale } from './hooks/locale.mjs';
+export { useLocaleFromEnvironment } from './hooks/locale-from-environment.mjs';
+export { LocalizedFormattingContext } from './context.mjs';
+export { LocalizedLink } from './routing/LocalizedLink.mjs';
+export { LocalizedNavigation } from './routing/LocalizedNavigation.mjs';
+export { LocalizedRouter } from './routing/LocalizedRouter.mjs';
+export { useRouteLocalization } from './routing/context.mjs';
+export { createRouteLocalization } from './routing/localization/by-locale.mjs';
+export { createRoutePathLocalization } from './routing/localization/by-path.mjs';
+export { createRouteSubdomainLocalization } from './routing/localization/by-subdomain.mjs';

package/build/esm/request-router.mjs

@@ -0,0 +1,49 @@
+import { RedirectResponse } from '@quilted/request-router';
+import { parseAcceptLanguageHeader } from '@quilted/localize';
+
+function createRequestRouterLocalization({
+  localization,
+  requestLocale: customRequestLocale
+}) {
+  const {
+    matchLocale,
+    redirectURL,
+    defaultLocale,
+    localeFromURL
+  } = localization;
+  const getDefaultLocaleFromRequest = request => {
+    const acceptLanguage = request.headers.get('Accept-Language');
+    return acceptLanguage && parseAcceptLanguageHeader(acceptLanguage) || undefined;
+  };
+  const getLocaleForRequest = customRequestLocale ?? getDefaultLocaleFromRequest;
+  function localeRedirect(request, {
+    to,
+    ...options
+  }) {
+    return new RedirectResponse(redirectURL(new URL(request.url), {
+      to
+    }), options);
+  }
+  return {
+    redirect: localeRedirect,
+    localizedRequestHandler(handler, {
+      include = () => true
+    } = {}) {
+      return async (request, ...args) => {
+        if (!include(request)) return handler(request, ...args);
+        const url = new URL(request.url);
+        const urlLocale = localeFromURL(url);
+        const requestLocale = getLocaleForRequest(request, () => getDefaultLocaleFromRequest(request));
+        const matchedLocale = (requestLocale == null ? undefined : matchLocale(requestLocale)) ?? defaultLocale;
+        if (urlLocale !== matchedLocale) {
+          return new RedirectResponse(redirectURL(url, {
+            to: matchedLocale
+          }));
+        }
+        return handler(request, ...args);
+      };
+    }
+  };
+}
+
+export { createRequestRouterLocalization };

package/build/esm/routing/LocalizedLink.mjs

@@ -0,0 +1,26 @@
+import { useMemo } from 'preact/hooks';
+import { useRouter, useCurrentURL, Link } from '@quilted/preact-router';
+import { useRouteLocalization } from './context.mjs';
+import { jsx } from 'preact/jsx-runtime';
+
+function LocalizedLink({
+  to,
+  locale,
+  ...props
+}) {
+  const router = useRouter();
+  const url = useCurrentURL();
+  const {
+    redirectURL
+  } = useRouteLocalization();
+  const resolvedURL = useMemo(() => redirectURL(to ? router.resolve(to).url : url, {
+    to: locale
+  }), [to, url, locale, redirectURL, router]);
+  return jsx(Link, {
+    hrefLang: locale,
+    to: resolvedURL,
+    ...props
+  });
+}
+
+export { LocalizedLink };

package/build/esm/routing/LocalizedNavigation.mjs

@@ -0,0 +1,48 @@
+import { useMemo } from 'preact/hooks';
+import { useBrowserDetails } from '@quilted/preact-browser';
+import { Navigation } from '@quilted/preact-router';
+import { Localization } from '../Localization.mjs';
+import { useLocaleFromEnvironment } from '../hooks/locale-from-environment.mjs';
+import { LocalizedRouter } from './LocalizedRouter.mjs';
+import { RouteLocalizationContext } from './context.mjs';
+import { jsx } from 'preact/jsx-runtime';
+
+function LocalizedNavigation({
+  locale: explicitLocale,
+  router,
+  routes,
+  context,
+  localization,
+  children
+}) {
+  const browser = useBrowserDetails({
+    optional: true
+  });
+  const resolvedRouter = useMemo(() => router ?? new LocalizedRouter(browser?.request.url, {
+    localization: localization
+  }), [router]);
+  const resolvedLocalization = resolvedRouter.localization;
+  const localeFromEnvironment = useLocaleFromEnvironment();
+  let resolvedLocale;
+  if (explicitLocale) {
+    resolvedLocale = explicitLocale;
+  } else if (localeFromEnvironment != null && localeFromEnvironment.toLowerCase().startsWith(resolvedLocalization.locale.toLowerCase())) {
+    resolvedLocale = localeFromEnvironment;
+  } else {
+    resolvedLocale = resolvedLocalization.locale;
+  }
+  return jsx(Localization, {
+    locale: resolvedLocale,
+    children: jsx(RouteLocalizationContext.Provider, {
+      value: resolvedLocalization,
+      children: jsx(Navigation, {
+        router: resolvedRouter,
+        routes: routes,
+        context: context,
+        children: children
+      })
+    })
+  });
+}
+
+export { LocalizedNavigation };

package/build/esm/routing/LocalizedRouter.mjs

@@ -0,0 +1,34 @@
+import { Router } from '@quilted/preact-router';
+
+class LocalizedRouter extends Router {
+  constructor(initial, {
+    localization,
+    isExternal: explicitIsExternal
+  }) {
+    const {
+      localeFromURL
+    } = localization;
+    super(initial, {
+      isExternal(url, currentURL) {
+        return matchedLocale !== localeFromURL(url) || (explicitIsExternal?.(url, currentURL) ?? false);
+      }
+    });
+    const currentURL = this.currentRequest.url;
+    const matchedLocale = localeFromURL(currentURL);
+    const resolvedLocalization = {
+      locale: matchedLocale ?? localization.defaultLocale,
+      ...localization
+    };
+    this.localization = resolvedLocalization;
+    const {
+      pathname: rootPath
+    } = localization.redirectURL(new URL('/', currentURL), {
+      to: resolvedLocalization.locale
+    });
+    if (rootPath.length > 1) Object.assign(this, {
+      base: rootPath
+    });
+  }
+}
+
+export { LocalizedRouter };

package/build/esm/routing/context.mjs

@@ -0,0 +1,6 @@
+import { createOptionalContext } from '@quilted/preact-context';
+
+const RouteLocalizationContext = createOptionalContext();
+const useRouteLocalization = RouteLocalizationContext.use;
+
+export { RouteLocalizationContext, useRouteLocalization };

package/build/esm/routing/localization/by-locale.mjs

@@ -0,0 +1,50 @@
+function createRouteLocalization({
+  locales: localeMap,
+  default: defaultLocale
+}) {
+  const sortedLocaleMap = [...localeMap].sort(([, a], [, b]) => b.length - a.length);
+  const locales = [...localeMap.keys()].sort((a, b) => b.length - a.length);
+  return {
+    locales,
+    redirectURL,
+    matchLocale,
+    localeFromURL,
+    defaultLocale
+  };
+  function matchLocale(requestLocale) {
+    const language = requestLocale.split('-')[0];
+    return locales.find(locale => locale === requestLocale || locale === language);
+  }
+  function localeFromURL(url) {
+    const hostname = url.hostname.toLowerCase();
+    const pathname = normalizePath(url.pathname.toLowerCase());
+    for (const [locale, target] of sortedLocaleMap) {
+      if (target.startsWith('/')) {
+        if (pathname.startsWith(target)) return locale;
+      } else {
+        if (hostname === target) return locale;
+      }
+    }
+  }
+  function redirectURL(from, {
+    to: toLocale
+  }) {
+    const fromLocale = localeFromURL(from);
+    const toUrl = new URL(from);
+    if (fromLocale === toLocale) return toUrl;
+    const target = localeMap.get(toLocale) ?? localeMap.get(defaultLocale);
+    if (target.startsWith('/')) {
+      const fromTarget = fromLocale == null ? '/' : localeMap.get(fromLocale) ?? '/';
+      toUrl.pathname = normalizePath(toUrl.pathname.replace(fromTarget, target));
+    } else {
+      toUrl.hostname = target;
+    }
+    return toUrl;
+  }
+}
+function normalizePath(path) {
+  if (path.length === 0) return '/';
+  return path.endsWith('/') && path.length > 1 ? path.slice(0, -1) : path;
+}
+
+export { createRouteLocalization };

package/build/esm/routing/localization/by-path.mjs

@@ -0,0 +1,23 @@
+import { createRouteLocalization } from './by-locale.mjs';
+
+function createRoutePathLocalization({
+  locales,
+  default: defaultLocaleDefinition
+}) {
+  const localeMap = new Map();
+  const defaultLocale = typeof defaultLocaleDefinition === 'string' ? defaultLocaleDefinition : defaultLocaleDefinition.locale;
+  const defaultLocaleNested = typeof defaultLocaleDefinition === 'string' || (defaultLocaleDefinition.nested ?? true);
+  for (const locale of locales) {
+    if (!defaultLocaleNested && locale === defaultLocale) {
+      localeMap.set(locale, '/');
+    } else {
+      localeMap.set(locale, `/${locale.toLowerCase()}`);
+    }
+  }
+  return createRouteLocalization({
+    locales: localeMap,
+    default: defaultLocale
+  });
+}
+
+export { createRoutePathLocalization };

package/build/esm/routing/localization/by-subdomain.mjs

@@ -0,0 +1,25 @@
+import { createRouteLocalization } from './by-locale.mjs';
+
+function createRouteSubdomainLocalization({
+  base,
+  locales,
+  default: defaultLocaleDefinition
+}) {
+  const localeMap = new Map();
+  const normalizedBase = base.replace(/^https?:\/\//, '');
+  const defaultLocale = typeof defaultLocaleDefinition === 'string' ? defaultLocaleDefinition : defaultLocaleDefinition.locale;
+  const defaultLocaleNested = typeof defaultLocaleDefinition === 'string' || (defaultLocaleDefinition.nested ?? true);
+  for (const locale of locales) {
+    if (!defaultLocaleNested && locale === defaultLocale) {
+      localeMap.set(locale, normalizedBase);
+    } else {
+      localeMap.set(locale, `${locale.toLowerCase()}.${normalizedBase}`);
+    }
+  }
+  return createRouteLocalization({
+    locales: localeMap,
+    default: defaultLocale
+  });
+}
+
+export { createRouteSubdomainLocalization };

package/build/esnext/Localization.esnext

@@ -0,0 +1,35 @@
+import { jsx, jsxs } from 'preact/jsx-runtime';
+import { useMemo } from 'preact/hooks';
+import { createLocalizedFormatting } from '@quilted/localize';
+import { HTMLAttributes } from '@quilted/preact-browser';
+import { LocaleContext, LocalizedFormattingContext } from './context.esnext';
+
+const RTL_LOCALES = /* @__PURE__ */ new Set([
+  "ar",
+  "arc",
+  "ckb",
+  "dv",
+  "fa",
+  "ha",
+  "he",
+  "khw",
+  "ks",
+  "ps",
+  "sd",
+  "ur",
+  "uz-AF",
+  "yi"
+]);
+function Localization({
+  locale,
+  direction = RTL_LOCALES.has(locale) ? "rtl" : "ltr",
+  children
+}) {
+  const formatting = useMemo(() => createLocalizedFormatting(locale), [locale]);
+  return /* @__PURE__ */ jsx(LocaleContext.Provider, { value: locale, children: /* @__PURE__ */ jsxs(LocalizedFormattingContext.Provider, { value: formatting, children: [
+    /* @__PURE__ */ jsx(HTMLAttributes, { lang: locale, dir: direction }),
+    children
+  ] }) });
+}
+
+export { Localization };

package/build/esnext/context.esnext

@@ -0,0 +1,6 @@
+import { createOptionalContext } from '@quilted/preact-context';
+
+const LocalizedFormattingContext = createOptionalContext();
+const LocaleContext = createOptionalContext();
+
+export { LocaleContext, LocalizedFormattingContext };

package/build/esnext/hooks/formatting.esnext

@@ -0,0 +1,5 @@
+import { LocalizedFormattingContext } from '../context.esnext';
+
+const useLocalizedFormatting = LocalizedFormattingContext.use;
+
+export { useLocalizedFormatting };

package/build/esnext/hooks/locale-from-environment.esnext

@@ -0,0 +1,13 @@
+import { parseAcceptLanguageHeader } from '@quilted/localize';
+import { useBrowserDetails } from '@quilted/preact-browser';
+
+function useLocaleFromEnvironment() {
+  if (typeof navigator === "object" && navigator.language) {
+    return navigator.language;
+  }
+  const browserDetails = useBrowserDetails({ optional: true });
+  const acceptLanguage = browserDetails?.request.headers?.get("Accept-Language");
+  return acceptLanguage && parseAcceptLanguageHeader(acceptLanguage);
+}
+
+export { useLocaleFromEnvironment };

package/build/esnext/hooks/locale.esnext

@@ -0,0 +1,5 @@
+import { LocaleContext } from '../context.esnext';
+
+const useLocale = LocaleContext.use;
+
+export { useLocale };