Referencia de Vanilla JS
create18waysEngine(options)
Importar desde @18ways/core/engine.
import { create18waysEngine } from '@18ways/core/engine';Opciones comunes:
| Opción | Tipo | Notas |
|---|---|---|
apiKey | cadena | Requerido. |
baseLocale | cadena | Idioma de origen. |
localización | cadena | Configuración regional actual. |
contexto | cadena | objeto | Clave de contexto predeterminada. |
traduccionesIniciales | Traducciones | Caché inicial opcional. |
apiUrl | cadena | Anulación opcional de la base de la API. |
fetcher | typeof fetch | Implementación de búsqueda personalizada. |
cacheTtlSeconds | número | Solicitar TTL de caché. |
origen | cadena | Origen reenviado en solicitudes del lado del servidor. |
Métodos de motor
t(text, options?)
Traduce una cadena y devuelve el valor resuelto.
setLocale(locale)
Cambia la configuración regional de destino.
getLocale()
Lee la configuración regional actual.
getStore()
Accede a la tienda de traducción subyacente.
TranslationStore
engine.getStore() expone la máquina de estados interna del entorno de ejecución. El store controla el estado de la configuración regional,
la config, las traducciones hidratadas, las cadenas de origen recordadas y el estado de carga bloqueante.
Métodos comunes:
| Método | Notas |
|---|---|
obtenerEstado() | Lee la configuración regional seleccionada actual, la configuración regional establecida, la configuración y las traducciones en caché. |
hydrate(input) | Combina las traducciones y la configuración en el store. Útil para SSR o para arranque personalizado. |
dehydrate() | Toma una instantánea de la tienda en una carga útil de hidratación compatible con fusiones. |
loadConfig() | Obtén las configuraciones regionales aceptadas y la configuración de respaldo una sola vez; después, guarda el resultado en caché. |
establecerLocale(locale) | Inicia una transición de configuración regional dentro de la tienda. |
getTranslationSync(input) | Lectura síncrona que devuelve un valor listo o una lectura pendiente con un valor de reserva. |
getTranslation(input) | Lectura de traducción asíncrona que se resuelve en la cadena traducida final. |
isLoading(input?) | Devuelve true cuando aún hay trabajo de traducción bloqueante pendiente, globalmente o para un contexto. |
waitForIdle(input?) | Se resuelve cuando el trabajo de traducción bloqueante se estabiliza. Pasa timeoutMs para dejar de esperar después de un límite de tiempo mientras la carga continúa en segundo plano. |
getIdleState(input?) | Devuelve el estado de espera por tiempo de la tienda usado por los renderizadores: {timedOut, promise}. |
montar(entry) / desmontar(entry) | Seguimiento opcional de montajes para integraciones que habilitan la recolección de basura con reconocimiento de montajes. |
Si estás usando @18ways/core directamente, por lo general te quedas en el nivel de engine.t(...). Recurre al
store cuando estés construyendo tu propio runtime de renderizado o capa de hidratación.
t() opciones
| Opción | Tipo | Notas |
|---|---|---|
localización | cadena | Anular la configuración regional objetivo para esta llamada. |
baseLocale | cadena | Sobrescribir la configuración regional base para esta llamada. |
contexto | cadena | objeto | Sobrescribir el contexto para esta llamada. |
vars | Registro<string, desconocido> | Entrada de variable para waysParser. |
Utility exports
El paquete principal también exporta ayudantes de nivel inferior como:
fetchAcceptedLocalesfetchConfig- utilidades de localización
Úsalos cuando los necesites, pero el motor debería ser el punto de partida por defecto.