@pithy-sh/i18n 0.12.0 → 0.14.0

package/dist/capability.d.ts

@@ -37,7 +37,7 @@ export interface I18nCapability extends Capability {
  * 1. the adopter's catalog for the resolved locale,
  * 2. the adopter's catalog for the project default,
  * 3. **the kit's translation** for the resolved locale — the `es` this package ships,
- * 4. every composed capability's English, for the resolved locale,
+ * 4. every composed capability's own copy for the resolved locale,
  * 5. every composed capability's copy for the project default,
  * 6. and their English, which is the language the kit is written in.
  *

package/dist/capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,0CAA0C,CAAC;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAKtF,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKnE;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,sGAAsG;IACtG,UAAU,EAAE,UAAU,CAAC;IACvB,qGAAqG;IACrG,gBAAgB,EAAE,cAAc,CAAC;IACjC,wEAAwE;IACxE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC;CACpE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,IAAI,CAAC,MAAM,GAAE,eAAoB,GAAG,cAAc,CA6EjE;AAED,uGAAuG;AACvG,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,IAAI,cAAc,CAErF"}
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,0CAA0C,CAAC;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAKtF,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKnE;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,sGAAsG;IACtG,UAAU,EAAE,UAAU,CAAC;IACvB,qGAAqG;IACrG,gBAAgB,EAAE,cAAc,CAAC;IACjC,wEAAwE;IACxE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC;CACpE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,IAAI,CAAC,MAAM,GAAE,eAAoB,GAAG,cAAc,CAyEjE;AAED,uGAAuG;AACvG,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,IAAI,cAAc,CAErF"}

package/dist/capability.js

@@ -28,7 +28,7 @@ import { DEFAULT_LOCALE } from "@pithy-sh/core/src/i18n/translator";
 * 1. the adopter's catalog for the resolved locale,
 * 2. the adopter's catalog for the project default,
 * 3. **the kit's translation** for the resolved locale — the `es` this package ships,
-* 4. every composed capability's English, for the resolved locale,
+* 4. every composed capability's own copy for the resolved locale,
 * 5. every composed capability's copy for the project default,
 * 6. and their English, which is the language the kit is written in.
 *

package/dist/catalogs/es/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/catalogs/es/errors.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,QAAQ,EAAE,cAiMtB,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/catalogs/es/errors.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,QAAQ,EAAE,cAqNtB,CAAC"}

package/dist/catalogs/es/errors.js

@@ -45,6 +45,7 @@ const esErrors = {
 	"auth/session_not_fresh": "Has entrado, pero no hace poco. Vuelve a entrar y reinténtalo. No se ha cambiado nada.",
 	"auth/account_suspended": "Tu cuenta está suspendida.",
 	"auth/account_deleted": "Tu cuenta está eliminada. Aún se puede recuperar durante un tiempo.",
+	"auth/handoff_invalid": "Ese código de acceso ya se usó o ha caducado. Vuelve a iniciar sesión.",
 	"core/not_found": "No existe el recurso solicitado.",
 	"core/conflict": "La solicitud entra en conflicto con el estado actual.",
 	"rate_limit/exceeded": "Demasiadas solicitudes. Inténtalo más tarde.",
@@ -56,6 +57,8 @@ const esErrors = {
 	"core/unknown_workflow": "La operación solicitada no existe.",
 	"core/workflow_failed": "La operación no se ha completado.",
 	"core/webhook_unverified": "La firma de la notificación no es válida.",
+	"core/presence_ticket_invalid": "Ese pase de presencia no es válido.",
+	"core/presence_room_full": "La sala está llena.",
 	"cloudflare/not_configured": "Este servicio no está disponible ahora.",
 	"cloudflare/request_failed": "No se ha podido completar la llamada a Cloudflare{apiAnswer}.",
 	"cloudflare/invalid_response": "La respuesta de Cloudflare no tiene el formato esperado.",
@@ -103,12 +106,23 @@ const esErrors = {
 	"ledger/insufficient_funds": "El saldo no es suficiente.",
 	"ledger/hold_not_open": "Esa reserva de saldo ya está resuelta.",
 	"ledger/invalid_amount": "El importe debe ser un número entero positivo.",
+	"ledger/entry_not_found": "Ese movimiento no existe.",
+	"ledger/entry_not_reversible": "Ese movimiento no se puede revertir.",
+	"ledger/ref_conflict": "Esa referencia ya pertenece a otro movimiento.",
 	"rating/unknown_algorithm": "Ese algoritmo de valoración no existe.",
 	"rating/unsupported_player_count": "Ese número de jugadores no es compatible con esta valoración.",
 	"rating/invalid_params": "Los parámetros de valoración no son válidos.",
 	"rating/game_not_found": "Ese juego no tiene valoración.",
 	"rating/pool_not_found": "Ese grupo de valoración no existe.",
 	"rating/record_forbidden": "No puedes registrar resultados valorados.",
+	"consent/unknown_purpose": "Ese propósito de consentimiento no existe.",
+	"consent/stale_notice": "El aviso ha cambiado. Vuelve a leerlo antes de aceptar.",
+	"consent/method_below_minimum": "Este consentimiento necesita una firma más fuerte.",
+	"consent/withdrawal_below_grant": "Para retirar este consentimiento, fírmalo igual que lo diste.",
+	"consent/evidence_missing": "Falta la firma o el documento que este consentimiento necesita.",
+	"consent/expiry_passed": "Esa fecha de caducidad ya ha pasado.",
+	"consent/document_not_found": "Ese documento firmado no existe.",
+	"consent/evidence_store_missing": "No se pudo guardar la firma.",
 	"matchmaking/room_not_found": "Ese código no corresponde a ninguna sala abierta.",
 	"matchmaking/room_full": "Esa sala ya no admite más jugadores.",
 	"matchmaking/invalid_code": "Ese código de sala no es válido.",
@@ -167,6 +181,10 @@ const esErrors = {
 	"organization/last_administrator": "La organización se quedaría sin nadie que pueda administrarla.",
 	"organization/slug_taken": "Ese identificador ya está en uso.",
 	"organization/nomination_invalid": "No hay ninguna oferta de titularidad que puedas aceptar.",
+	"organization/last_owner": "Es la única persona titular de la organización. Transfiere la titularidad primero.",
+	"organization/already_member": "Esa persona ya es miembro de la organización.",
+	"organization/seat_limit_reached": "La organización no tiene plazas libres.",
+	"organization/organization_suspended": "Esta organización está suspendida. Tu propia cuenta no se ve afectada.",
 	"artifacts/not_found": "Ese repositorio no existe.",
 	"artifacts/forbidden": "No puedes hacer eso en este repositorio.",
 	"artifacts/invalid_name": "Ese nombre de repositorio no es válido.",

package/dist/catalogs/es/screens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screens.d.ts","sourceRoot":"","sources":["../../../src/catalogs/es/screens.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,SAAS,EAAE,cA8JvB,CAAC"}
+{"version":3,"file":"screens.d.ts","sourceRoot":"","sources":["../../../src/catalogs/es/screens.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,SAAS,EAAE,cA2PvB,CAAC"}

package/dist/catalogs/es/screens.js

@@ -51,6 +51,10 @@ const esScreens = {
 	"auth/otp.failed": "Ese código no funcionó. Inténtalo otra vez o pide uno nuevo.",
 	"auth/otp.submit": "Entrar",
 	"auth/otp.resend": "Enviar un código nuevo",
+	"auth/otp.ask.submit": "Envíame un código",
+	"auth/otp.ask.provider_unconfigured": "{provider} no está configurado aquí. Usa un código.",
+	"auth/otp.ask.provider_silent": "{provider} no respondió. Usa un código.",
+	"auth/otp.ask.signup_email_only": "Te enviamos un código y se crea una. Los botones de arriba solo entran en cuentas que ya existen.",
 	"auth/callback.title": "Entrando.",
 	"auth/callback.body": "Un momento.",
 	"auth/suspended.title": "Tu cuenta está suspendida.",
@@ -63,6 +67,37 @@ const esScreens = {
 	"auth/deleted.detail": "Hasta entonces se puede recuperar. Te enviamos la fecha a la dirección de tu cuenta.",
 	"auth/deleted.contact": "Para recuperarla, responde a ese correo antes de esa fecha.",
 	"auth/deleted.sign_out": "Cerrar sesión",
+	"auth/consent.title": "Una aplicación quiere actuar en tu nombre.",
+	"auth/consent.reported": "Se presenta como {name}. Ese nombre lo puso ella, y nadie lo ha comprobado.",
+	"auth/consent.unnamed": "No dio ningún nombre.",
+	"auth/consent.verified": "Comprobado: se publica en",
+	"auth/consent.redirect": "El acceso se enviará a",
+	"auth/consent.redirect_note": "Aprueba solo si empezaste esto desde esa aplicación.",
+	"auth/consent.can_do": "Si apruebas, podrá:",
+	"auth/consent.count.one": "{reachable} de {count} operación en {capability}.",
+	"auth/consent.count.other": "{reachable} de {count} operaciones en {capability}.",
+	"auth/consent.withheld.one": "{count} más necesita un rol que no tienes.",
+	"auth/consent.withheld.other": "{count} más necesitan un rol que no tienes.",
+	"auth/consent.nothing": "Tu rol todavía no le permite nada aquí. Gana lo que gane tu rol.",
+	"auth/consent.refused_scope": "{scope}: {reason}",
+	"auth/consent.not_granted.role": "Solicitado, y no concedido, porque tu rol no lo incluye.",
+	"auth/consent.not_granted.unknown": "Solicitado, y no concedido, porque esta aplicación no tiene ese permiso.",
+	"auth/consent.bound": "Si apruebas, esta aplicación actuará en tu nombre. Nunca podrá hacer más de lo que tu rol permite, y pierde todo lo que tu rol pierda.",
+	"auth/consent.approve": "Dejar que actúe en mi nombre",
+	"auth/consent.deny": "No permitir",
+	"auth/consent.expired": "Esta solicitud ha caducado. Empieza de nuevo desde la aplicación.",
+	"auth/consent.effect.writes": "cambia datos",
+	"auth/consent.effect.sends": "envía un mensaje",
+	"auth/consent.effect.charges": "cobra dinero",
+	"auth/consent.effect.deletes": "borra datos",
+	"auth/connected.title": "Aplicaciones que actúan en tu nombre",
+	"auth/connected.empty": "Ninguna. Nada actúa en tu nombre.",
+	"auth/connected.unnamed": "Una aplicación sin nombre",
+	"auth/connected.verified": "Publicada en {host}. Eso está comprobado.",
+	"auth/connected.approved": "Aprobada el {date}. El acceso va a {redirect}.",
+	"auth/connected.revoke": "Revocar",
+	"auth/connected.failed": "No pudimos cargar tus aplicaciones.",
+	"auth/connected.retry": "Reintentar",
 	"organization/suspended.title": "Esta organización está suspendida.",
 	"organization/suspended.body": "Nadie puede usarla hasta que se reactive. Tu propia cuenta no se ve afectada.",
 	"organization/suspended.contact": "A sus propietarios se les dijo el motivo. Pregunta a uno de ellos.",
@@ -74,6 +109,18 @@ const esScreens = {
 	"organization/choose.empty.body": "No eres miembro de ninguna cuenta. Pide que alguien te invite.",
 	"organization/choose.failed": "No hemos podido cargar tus cuentas.",
 	"organization/choose.retry": "Reintentar",
+	"organization/invitation.title": "Únete a {organization}",
+	"organization/invitation.invited_by": "{inviter} te invitó como {role}.",
+	"organization/invitation.invited": "Te invitaron como {role}.",
+	"organization/invitation.expires": "La invitación caduca el {date}.",
+	"organization/invitation.as": "Te unirás como {email}.",
+	"organization/invitation.accept": "Unirme",
+	"organization/invitation.sign_in": "Inicia sesión para aceptar",
+	"organization/invitation.invalid.title": "Esta invitación no se puede usar.",
+	"organization/invitation.invalid.body": "Caducó, ya se usó o se retiró, o se envió a otra dirección. Pide una nueva a quien te invitó.",
+	"organization/invitation.failed": "No hemos podido cargar esta invitación.",
+	"organization/invitation.join_failed": "No hemos podido terminar de unirte.",
+	"organization/invitation.retry": "Reintentar",
 	"payments/paywall.title": "Ve más lejos.",
 	"payments/paywall.body": "Elige lo que necesitas. Puedes cambiar de idea más tarde.",
 	"payments/paywall.buy": "Comprar {product}",
@@ -84,6 +131,10 @@ const esScreens = {
 	"payments/paywall.done.title": "Todo listo.",
 	"payments/paywall.done.body": "Gracias. Tu compra ya está en tu cuenta.",
 	"payments/paywall.done.home": "Ir al inicio",
+	"payments/paywall.restore": "Restaurar compras",
+	"payments/paywall.nothing_to_restore": "La tienda no tiene nada que restaurar para esta cuenta.",
+	"payments/paywall.restored_elsewhere": "Tus compras se han restaurado. Ninguna incluye lo que se vende aquí.",
+	"payments/paywall.pending": "La tienda aún está procesando esta compra. Aparecerá en tu cuenta cuando se confirme.",
 	"payments/pricing.title": "Lo que cuesta.",
 	"payments/pricing.body": "Los precios son para donde estás. Los impuestos los calcula Paddle, no nosotros.",
 	"payments/pricing.anonymous": "Cualquiera puede ver un precio. Comprar necesita cuenta.",
@@ -93,6 +144,11 @@ const esScreens = {
 	"payments/pricing.sign_in": "Entra para comprar {product}",
 	"payments/pricing.buy": "Comprar {product}",
 	"payments/pricing.holdings": "¿Qué tengo ya?",
+	"payments/pricing.store_body": "Los precios son los de la tienda, para donde estás.",
+	"payments/pricing.at_checkout": "Verás el precio al pagar.",
+	"payments/pricing.done": "Gracias. Tu compra ya está en tu cuenta.",
+	"payments/pricing.pending": "La tienda aún está procesando esta compra. Aparecerá en tu cuenta cuando se confirme.",
+	"payments/pricing.empty.rail": "Nada de aquí se vende por el método de pago de esta plataforma. Dale a un producto su SKU en ese método en",
 	"payments/pricing.every.one": "al {interval}",
 	"payments/pricing.every.other": "cada {count} {interval}s",
 	"payments/pricing.empty.title": "Aquí no hay precios.",
@@ -111,6 +167,28 @@ const esScreens = {
 	"payments/subscription.apple": "Comprado en la App Store",
 	"payments/subscription.google": "Comprado en Google Play",
 	"payments/subscription.more": "Ver qué más hay",
+	"payments/checkout.in_page": "Este pago se abre dentro de una página web, y la app no puede mostrarla.",
+	"payments/store.unavailable": "La tienda no ha respondido. Inténtalo de nuevo en un momento.",
+	"payments/store.refused": "La tienda no ha terminado la compra.",
+	"payments/store.no_token": "Este dispositivo no ha podido guardar lo que marca una compra como tuya, así que no se ha comprado nada.",
+	"payments/store.signed_out": "Inicia sesión antes de comprar.",
+	"payments/store.no_answer": "La tienda no ha respondido. Si la compra se completa, llegará a tu cuenta sola.",
+	"consent/settings.title": "Tus opciones de privacidad.",
+	"consent/settings.loading": "Un momento.",
+	"consent/settings.unreadable": "No pudimos cargar tus opciones.",
+	"consent/settings.none": "Aquí nada pide tu consentimiento.",
+	"consent/settings.on": "Activado.",
+	"consent/settings.off": "Desactivado.",
+	"consent/settings.renew": "El aviso ha cambiado. Acepta de nuevo para mantenerlo.",
+	"consent/settings.expired": "Ha caducado.",
+	"consent/settings.agree": "Aceptar",
+	"consent/settings.withdraw": "Retirar",
+	"consent/settings.signed_elsewhere": "Necesita tu firma en el documento que cubre.",
+	"consent/settings.type_name": "Escribe tu nombre completo para retirarlo por escrito",
+	"consent/settings.draw_name": "Firma abajo para retirarlo por escrito",
+	"consent/settings.clear": "Borrar",
+	"consent/settings.signed_with_provider": "Lo firmaste con un servicio de firma electrónica. Retíralo donde lo firmaste.",
+	"consent/settings.saved": "Guardado.",
 	"app/loading": "Un momento.",
 	"app/not_found.title": "Aquí no hay nada.",
 	"app/not_found.body": "Nada responde en {path}.",
@@ -124,6 +202,7 @@ const esScreens = {
 	"app/home.bare.checking": "comprobando",
 	"app/home.bare.unknown": "desconocido",
 	"app/home.bare.unreachable": "inaccesible",
+	"app/locale.reload_required": "Reinicia la app para terminar de cambiar el idioma.",
 	"client/unreachable": "No hemos podido conectar.",
 	"client/unreadable": "La respuesta no se ha podido leer.",
 	"client/cross_origin": "Esa petición habría salido de este sitio, así que no se ha enviado.",

package/dist/config/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;EAE2F,CAAC;AACvH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;EAIzB,CAAC;AACJ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAgC9D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;iBA4E8E,CAAC;AACtG,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;EAE2F,CAAC;AACvH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;EAIzB,CAAC;AACJ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AA+B9D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;iBA4E8E,CAAC;AACtG,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/config/config.js

@@ -40,7 +40,6 @@ const DEFAULT_SERVER_RESOLVERS = [
 	"header",
 	"default"
 ];
-/** The browser chain's default order — `?lang=`, account, local storage, the server's answer, default. */
 /**
 * The browser chain's default order — `?lang=`, account, this device's memory, the reader's own
 * browser languages, what the server declared, the project default.

package/dist/native/environment.d.ts

@@ -0,0 +1,16 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+import type { LocaleEnvironment } from "../react/localeEnvironment";
+/**
+ * React Native's locale environment. Pass it as `useNegotiatedLocale(projection, { environment: nativeLocaleEnvironment })`.
+ *
+ * - **Starting signals:** the device's preferred languages from `expo-localization`, in the order the reader set
+ *   them, and a choice remembered in AsyncStorage. `useLocales` re-renders when the operating system's language
+ *   changes, so the app follows it while it runs. There is no query string and no server-rendered `lang`, so those
+ *   two links of the chain answer nothing.
+ * - **Remember:** AsyncStorage, under the projection's `storageKey`. A locale is not a secret, so it is not kept in
+ *   the secure store.
+ * - **Apply:** `I18nManager`, whose direction takes effect after a reload. `reloadRequired` says when.
+ */
+export declare const nativeLocaleEnvironment: LocaleEnvironment;
+//# sourceMappingURL=environment.d.ts.map

package/dist/native/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/native/environment.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,4BAA4B,CAAC;AAIhF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,EAAE,iBAIrC,CAAC"}

package/dist/native/environment.js

@@ -0,0 +1,56 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+import { useNativeDirection } from "./useNativeDirection.js";
+import { useRead } from "@pithy-sh/ui-core/src/read";
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import { useLocales } from "expo-localization";
+import { useMemo } from "react";
+//#region src/native/environment.ts
+/**
+* React Native's locale environment. Pass it as `useNegotiatedLocale(projection, { environment: nativeLocaleEnvironment })`.
+*
+* - **Starting signals:** the device's preferred languages from `expo-localization`, in the order the reader set
+*   them, and a choice remembered in AsyncStorage. `useLocales` re-renders when the operating system's language
+*   changes, so the app follows it while it runs. There is no query string and no server-rendered `lang`, so those
+*   two links of the chain answer nothing.
+* - **Remember:** AsyncStorage, under the projection's `storageKey`. A locale is not a secret, so it is not kept in
+*   the secure store.
+* - **Apply:** `I18nManager`, whose direction takes effect after a reload. `reloadRequired` says when.
+*/
+const nativeLocaleEnvironment = {
+	useSignals: useNativeSignals,
+	remember: (locale, keys) => AsyncStorage.setItem(keys.storageKey, locale),
+	useApply: (enabled, _locale, direction) => useNativeDirection(enabled, direction)
+};
+/** The device's languages and this device's remembered choice; `undefined` until the memory has been read. */
+function useNativeSignals(keys) {
+	const device = useLocales();
+	const storageKey = keys?.storageKey;
+	const memory = useRead(`pithy-locale-memory:${storageKey ?? ""}`, async () => storageKey === void 0 ? null : readMemory(storageKey), { skip: storageKey === void 0 });
+	const navigator = useMemo(() => {
+		const tags = device.map((entry) => entry.languageTag).filter((tag) => tag.trim().length > 0);
+		return tags.length > 0 ? tags : null;
+	}, [device]);
+	const remembered = memory.value ?? null;
+	const ready = storageKey !== void 0 && !memory.loading;
+	return useMemo(() => ready ? {
+		query: null,
+		storage: remembered,
+		navigator,
+		server: null
+	} : void 0, [
+		ready,
+		remembered,
+		navigator
+	]);
+}
+/** The remembered choice, or `null` when there is none or the store refuses. */
+async function readMemory(storageKey) {
+	try {
+		return await AsyncStorage.getItem(storageKey);
+	} catch {
+		return null;
+	}
+}
+//#endregion
+export { nativeLocaleEnvironment };

package/dist/native/useNativeDirection.d.ts

@@ -0,0 +1,13 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+/**
+ * Keep `I18nManager`'s direction in step with the locale in force, and answer whether it needs a reload.
+ *
+ * React Native reads the direction once, at launch: `forceRTL` changes the next launch, and `isRTL` keeps answering
+ * for this one. So the answer is a comparison, not a flag the effect sets. `allowRTL` moves with `forceRTL`, so an
+ * English choice on an Arabic device lays out left to right rather than following the device.
+ *
+ * `enabled` false touches nothing and asks for no reload.
+ */
+export declare function useNativeDirection(enabled: boolean, direction: "ltr" | "rtl"): boolean;
+//# sourceMappingURL=useNativeDirection.d.ts.map

package/dist/native/useNativeDirection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNativeDirection.d.ts","sourceRoot":"","sources":["../../src/native/useNativeDirection.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,CAQtF"}

package/dist/native/useNativeDirection.js

@@ -0,0 +1,25 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+import { useEffect } from "react";
+import { I18nManager } from "react-native";
+//#region src/native/useNativeDirection.ts
+/**
+* Keep `I18nManager`'s direction in step with the locale in force, and answer whether it needs a reload.
+*
+* React Native reads the direction once, at launch: `forceRTL` changes the next launch, and `isRTL` keeps answering
+* for this one. So the answer is a comparison, not a flag the effect sets. `allowRTL` moves with `forceRTL`, so an
+* English choice on an Arabic device lays out left to right rather than following the device.
+*
+* `enabled` false touches nothing and asks for no reload.
+*/
+function useNativeDirection(enabled, direction) {
+	const rtl = direction === "rtl";
+	useEffect(() => {
+		if (!enabled) return;
+		I18nManager.allowRTL(rtl);
+		I18nManager.forceRTL(rtl);
+	}, [enabled, rtl]);
+	return enabled && I18nManager.isRTL !== rtl;
+}
+//#endregion
+export { useNativeDirection };

package/dist/react/browserLocaleEnvironment.d.ts

@@ -0,0 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+import type { LocaleEnvironment } from "./localeEnvironment";
+/** The browser's locale environment: what `useNegotiatedLocale` uses when it is handed none. */
+export declare const browserLocaleEnvironment: LocaleEnvironment;
+//# sourceMappingURL=browserLocaleEnvironment.d.ts.map

package/dist/react/browserLocaleEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserLocaleEnvironment.d.ts","sourceRoot":"","sources":["../../src/react/browserLocaleEnvironment.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,qBAAqB,CAAC;AAoBzE,gGAAgG;AAChG,eAAO,MAAM,wBAAwB,EAAE,iBAItC,CAAC"}

package/dist/react/browserLocaleEnvironment.js

@@ -0,0 +1,28 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+import { readBrowserSignals, rememberBrowserLocale } from "../browser/signals.js";
+import { useDocumentLocale } from "./useDocumentLocale.js";
+import { useMemo } from "react";
+//#region src/react/browserLocaleEnvironment.ts
+/** The query string, `localStorage`, `navigator` and `<html lang>`, read once per pair of names. */
+function useBrowserSignals(keys) {
+	const queryParam = keys?.queryParam;
+	const storageKey = keys?.storageKey;
+	return useMemo(() => queryParam === void 0 || storageKey === void 0 ? void 0 : readBrowserSignals({
+		queryParam,
+		storageKey
+	}), [queryParam, storageKey]);
+}
+/** `lang` and `dir` on the document. A browser lays out a new direction at once, so no reload is ever needed. */
+function useDocumentApply(enabled, locale, direction) {
+	useDocumentLocale(enabled, locale, direction);
+	return false;
+}
+/** The browser's locale environment: what `useNegotiatedLocale` uses when it is handed none. */
+const browserLocaleEnvironment = {
+	useSignals: useBrowserSignals,
+	remember: rememberBrowserLocale,
+	useApply: useDocumentApply
+};
+//#endregion
+export { browserLocaleEnvironment };

package/dist/react/localeEnvironment.d.ts

@@ -0,0 +1,29 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+import type { BrowserChain, BrowserLocaleSignals } from "../resolve/browser";
+/** The two names a client looks its own signals up by. */
+export type LocaleKeys = Pick<BrowserChain, "queryParam" | "storageKey">;
+/**
+ * Where `useNegotiatedLocale` gets its starting signals, where it remembers a choice, and how it applies the locale.
+ *
+ * The browser's is the default; `@pithy-sh/i18n/src/native/environment` is React Native's. Both hooks are called on
+ * every render, so the environment a component passes must be the same one for the life of that component: a module
+ * constant, never an object built in the render.
+ */
+export interface LocaleEnvironment {
+    /**
+     * The signals this platform holds, as a hook, so a source that changes while the app runs, or answers after the
+     * first render, re-renders the caller. `undefined` while a signal is still being read: nothing is negotiated, no
+     * catalog is asked for and nothing is applied until it answers. `keys` is `null` when the capability is not
+     * composed, and nothing is read.
+     */
+    readonly useSignals: (keys: LocaleKeys | null) => BrowserLocaleSignals | undefined;
+    /** Remember a choice on this device. Not awaited; a rejection is caught. */
+    readonly remember: (locale: string, keys: LocaleKeys) => void | Promise<void>;
+    /**
+     * Apply the locale in force, as a hook. Answers `true` when the direction it applied takes effect only after the
+     * app reloads, which is React Native's rule for `I18nManager`. The browser always answers `false`.
+     */
+    readonly useApply: (enabled: boolean, locale: string, direction: "ltr" | "rtl") => boolean;
+}
+//# sourceMappingURL=localeEnvironment.d.ts.map

package/dist/react/localeEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localeEnvironment.d.ts","sourceRoot":"","sources":["../../src/react/localeEnvironment.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY,CAAC,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,oBAAoB,GAAG,SAAS,CAAC;IACnF,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,KAAK,KAAK,OAAO,CAAC;CAC5F"}

package/dist/react/localeEnvironment.js

@@ -0,0 +1,2 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT

package/dist/react/useDocumentLocale.d.ts

@@ -0,0 +1,10 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+/**
+ * Keep `lang` and `dir` on the document in step with the locale in force.
+ *
+ * `enabled` false writes nothing: a project without the capability keeps the `lang` its `index.html` shipped,
+ * because restamping the document with a locale no chain chose would declare a language nothing negotiated.
+ */
+export declare function useDocumentLocale(enabled: boolean, locale: string, direction: "ltr" | "rtl"): void;
+//# sourceMappingURL=useDocumentLocale.d.ts.map

package/dist/react/useDocumentLocale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocumentLocale.d.ts","sourceRoot":"","sources":["../../src/react/useDocumentLocale.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI,CAKlG"}

package/dist/react/useDocumentLocale.js

@@ -0,0 +1,23 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+import { applyDocumentLocale } from "../browser/signals.js";
+import { useEffect } from "react";
+//#region src/react/useDocumentLocale.ts
+/**
+* Keep `lang` and `dir` on the document in step with the locale in force.
+*
+* `enabled` false writes nothing: a project without the capability keeps the `lang` its `index.html` shipped,
+* because restamping the document with a locale no chain chose would declare a language nothing negotiated.
+*/
+function useDocumentLocale(enabled, locale, direction) {
+	useEffect(() => {
+		if (!enabled) return;
+		applyDocumentLocale(locale, direction);
+	}, [
+		enabled,
+		locale,
+		direction
+	]);
+}
+//#endregion
+export { useDocumentLocale };

package/dist/react/useNegotiatedLocale.d.ts

@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: MIT
 import type { MessageCatalog } from "@pithy-sh/core/src/i18n/catalog";
 import type { I18nClientProjection } from "../client/projection";
+import type { LocaleEnvironment } from "./localeEnvironment";
 import type { TranslatorSource } from "./translator";
 /** What the hook hands back: what to mount, what was chosen, and how to choose again. */
 export interface NegotiatedLocale {
@@ -13,8 +14,14 @@ export interface NegotiatedLocale {
     readonly source: TranslatorSource | null;
     /** The catalog locale in force — the words the app has. */
     readonly locale: string;
-    /** Choose a language. Remembers it on this device and puts `lang`/`dir` on the document. */
+    /** Choose a language. Remembers it on this device and applies it through the environment. */
     readonly choose: (locale: string) => void;
+    /**
+     * `true` when the locale in force lays out in the other direction from the one this launch started with, and the
+     * new direction takes effect only after the app reloads. React Native's rule; a browser never answers `true`. A
+     * screen says so rather than flip half a layout.
+     */
+    readonly reloadRequired: boolean;
 }
 /** What the caller knows that the browser cannot work out for itself. */
 export interface NegotiatedLocaleOptions {
@@ -42,10 +49,16 @@ export interface NegotiatedLocaleOptions {
      * catch it here where you know what your API meant.
      */
     readonly persist?: (locale: string) => void | Promise<void>;
+    /**
+     * Where the starting signals come from, where a choice is remembered and how the locale is applied. The browser's
+     * by default; pass `nativeLocaleEnvironment` from `@pithy-sh/i18n/src/native/environment` on React Native. Keep it
+     * the same object for the life of the component.
+     */
+    readonly environment?: LocaleEnvironment;
 }
 /**
- * Negotiate the reader's locale in the browser, load that locale's catalog, and keep the document in
- * step.
+ * Negotiate the reader's locale, load that locale's catalog, and keep the platform in step: the document in a
+ * browser, `I18nManager` on React Native, through `options.environment`.
  *
  * **It takes what a browser holds.** `projection` is `virtual:pithy/i18n` — locale metadata and nothing
  * else — so a screen reads the chain order **this project** configured rather than one the front end

package/dist/react/useNegotiatedLocale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useNegotiatedLocale.d.ts","sourceRoot":"","sources":["../../src/react/useNegotiatedLocale.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAKtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED,yEAAyE;AACzE,MAAM,WAAW,uBAAuB;IACtC,kGAAkG;IAClG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC;IACzE;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAWD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,oBAAoB,EAChC,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CA6GlB"}
+{"version":3,"file":"useNegotiatedLocale.d.ts","sourceRoot":"","sources":["../../src/react/useNegotiatedLocale.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAKtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,yEAAyE;AACzE,MAAM,WAAW,uBAAuB;IACtC,kGAAkG;IAClG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC;IACzE;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CAC1C;AAWD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,oBAAoB,EAChC,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CAgGlB"}