@fayz-ai/core 0.9.0 → 0.10.0

package/src/i18n/index.ts

@@ -1,476 +0,0 @@
-import * as React from 'react'
-import { shellTranslationsEn } from './shell-translations.en'
-
-export interface I18nConfig {
-  defaultLocale: string
-  supported: string[]
-  translations: Record<string, Record<string, string>>
-}
-
-const I18nContext = React.createContext<I18nConfig>({
-  defaultLocale: 'en',
-  supported: ['en'],
-  translations: {},
-})
-
-export const I18nProvider = I18nContext.Provider
-
-export function useI18nConfig(): I18nConfig {
-  return React.useContext(I18nContext)
-}
-
-export function useTranslation(): (key: string, params?: Record<string, string | number>) => string {
-  const config = React.useContext(I18nContext)
-  const localeStore = useLocaleStore()
-  const locale = localeStore.locale
-
-  return React.useCallback(
-    (key: string, params?: Record<string, string | number>): string => {
-      const localizedTranslations = config.translations[locale] ?? {}
-      const fallback = config.translations[config.defaultLocale] ?? {}
-      // Global fallback lets plugins register their locales independently of any
-      // I18nProvider — needed when a de-bridged plugin runs under a host shell
-      // that doesn't mount @fayz-ai/core's I18nProvider (incremental de-bridge), and
-      // for manifest apps where plugins self-register translations.
-      const gLocale = _globalTranslations[locale] ?? {}
-      const gFallback = _globalTranslations[config.defaultLocale] ?? {}
-      let raw = localizedTranslations[key] ?? gLocale[key] ?? fallback[key] ?? gFallback[key] ?? key
-
-      if (params) {
-        for (const [k, v] of Object.entries(params)) {
-          raw = raw.replace(new RegExp(`\\{\\{${k}\\}\\}`, 'g'), String(v))
-        }
-      }
-      return raw
-    },
-    [config, locale],
-  )
-}
-
-// Minimal locale store (avoids circular dep with stores package)
-interface LocaleStore {
-  locale: string
-  setLocale: (locale: string) => void
-}
-
-let _localeStore: LocaleStore = {
-  locale: 'en',
-  setLocale: (l) => { _localeStore.locale = l },
-}
-const _localeListeners = new Set<() => void>()
-
-export function setLocaleStore(store: LocaleStore): void {
-  _localeStore = store
-}
-
-// Bumped when lazily-loaded translations register so subscribed components
-// re-render even though the locale string itself did not change.
-let _i18nVersion = 0
-function getI18nSnapshot(): string {
-  return `${_localeStore.locale} ${_i18nVersion}`
-}
-
-function useLocaleStore(): LocaleStore {
-  const snapshot = React.useSyncExternalStore(
-    (listener) => {
-      _localeListeners.add(listener)
-      return () => _localeListeners.delete(listener)
-    },
-    getI18nSnapshot,
-    getI18nSnapshot,
-  )
-  return React.useMemo(() => {
-    const locale = snapshot.slice(0, snapshot.indexOf(' '))
-    return { locale, setLocale: setCurrentLocale }
-  }, [snapshot])
-}
-
-export function getCurrentLocale(): string {
-  return _localeStore.locale
-}
-
-export function setCurrentLocale(locale: string): void {
-  if (_localeStore.locale === locale) return
-  _localeStore.setLocale(locale)
-  // Fire-and-forget: if the locale's shell translations are lazily split, load
-  // and register them; keys fall back to 'en' until the chunk arrives.
-  void preloadLocale(locale)
-  _localeListeners.forEach((listener) => listener())
-}
-
-// Core built-in translations
-export const coreTranslations: Record<string, Record<string, string>> = {
-  en: {
-    'common.save': 'Save',
-    'common.saveChanges': 'Save Changes',
-    'common.saving': 'Saving...',
-    'common.cancel': 'Cancel',
-    'common.delete': 'Delete',
-    'common.edit': 'Edit',
-    'common.close': 'Close',
-    'common.confirm': 'Confirm',
-    'common.discard': 'Discard',
-    'common.back': 'Back',
-    'common.formIncomplete': 'Fill in the required fields before saving.',
-    'connectors.title': 'Integrations',
-    'connectors.subtitle': 'Connect external providers to this module.',
-    'connectors.connected': 'Connected',
-    'connectors.notConnected': 'Not connected',
-    'connectors.connect': 'Connect',
-    'connectors.disconnect': 'Disconnect',
-    'connectors.test': 'Test',
-    'connectors.save': 'Save connection',
-    'connectors.testing': 'Testing…',
-    'connectors.saving': 'Saving…',
-    'connectors.empty': 'No integrations available for this module yet.',
-    'connectors.configure': 'Configure',
-    'connectors.hubSubtitle': 'Apps, assistants and providers connected to this organization.',
-    'connectors.add': 'Add connector',
-    'connectors.addSubtitle': 'Integrations available on Fayz for this organization.',
-    'connectors.search': 'Search integration…',
-    'connectors.noneFound': 'No integration found for “{{query}}”.',
-    'connectors.viewAll': 'See every connector',
-    'connectors.groupMine': 'In this organization',
-    'connectors.groupOffered': 'Offered by Fayz',
-    'connectors.docs': 'Provider documentation',
-    'connectors.builtIn': 'native',
-    'connectors.partOfApp': 'part of the app',
-    'connectors.plane.agentic': 'Assistant',
-    'connectors.plane.agentic.desc': 'The assistant uses the provider’s own tools on demand. Nothing is copied.',
-    'connectors.plane.sync': 'Sync',
-    'connectors.plane.sync.desc': 'A pipeline keeps a copy of the data inside the app.',
-    'connectors.plane.recommended': 'recommended',
-    'connectors.plane.undecided': 'How this one is resolved is decided by Fayz when the integration ships.',
-    'connectors.plane.switched': 'Mode changed',
-    'connectors.plane.lockedHint': 'This connection cannot change mode after the fact — disconnect and connect again.',
-    'connectors.direction.inbound': 'inbound',
-    'connectors.direction.outbound': 'outbound',
-    'connectors.state.connected': 'connected',
-    'connectors.state.ready': 'ready to connect',
-    'connectors.state.catalog': 'available on Fayz',
-    'connectors.state.soon': 'coming soon',
-    'connectors.journey.what': 'What it does',
-    'connectors.journey.how': 'How it gets resolved',
-    'connectors.journey.authorize': 'Authorize',
-    'connectors.journey.access': 'Access',
-    'connectors.journey.after': 'Once connected',
-    'connectors.after.agentic': 'These tools are available to the assistant right now.',
-    'connectors.after.willAgentic': 'The assistant gains this provider’s tools; no copy of the data is made.',
-    'connectors.after.willSync': 'A pipeline starts keeping this data in agreement, with mapping and history.',
-    'connectors.tools': 'Assistant tools',
-    'connectors.entitiesCount': 'reaches {{count}} record types',
-    'connectors.entitiesList': 'Records: {{list}}',
-    'connectors.capabilitiesUnknown': 'This connector has not published what it reaches yet.',
-    'connectors.readOnly': 'read only',
-    'connectors.readWrite': 'read and write',
-    'connectors.needsPlugin': 'Fayz has this integration built, but this app does not have the plugin that hosts it.',
-    'connectors.soonBody': 'Fayz lists this provider, but the integration is not wired yet.',
-    'connectors.connectedOn': 'Connected on {{date}}',
-    'connectors.lastUsed': 'used {{when}}',
-    'connectors.neverUsed': 'not used yet',
-    'connectors.grantedByOther': 'authorized by someone else on the team',
-    'connectors.revokeConfirm': 'Disconnect {{name}}? It loses access immediately.',
-    'connectors.filter.all': 'All',
-    'connectors.filter.connected': 'Connected',
-    'connectors.filter.agentic': 'Assistant',
-    'connectors.filter.sync': 'Sync',
-    'connectors.emptyTitle': 'No connectors',
-    'connectors.emptyBody': 'Connect a provider, or authorize an external assistant, and it shows up here.',
-    'connectors.noProject': 'Connectors unavailable',
-    'connectors.noProjectBody': 'This app is not linked to a Fayz project.',
-    'connectors.noOrg': 'No organization',
-    'connectors.noOrgBody': 'Pick an organization to see its connections.',
-    'saveBar.unsaved': 'Unsaved changes',
-    'common.add': 'Add',
-    'common.loading': 'Loading...',
-    'common.error': 'Something went wrong',
-    'common.noResults': 'No results found.',
-    'common.search': 'Search',
-    'common.actions': 'Actions',
-    'common.continue': 'Continue',
-    'common.done': 'Done',
-    'common.yes': 'Yes',
-    'common.no': 'No',
-    'common.active': 'Active',
-    'common.inactive': 'Inactive',
-    'common.overview': 'Overview',
-    'common.settings': 'Settings',
-    'common.plugins': 'Plugins',
-    'common.new': 'New',
-    'common.filter': 'Filter',
-    'common.export': 'Export',
-    'common.import': 'Import',
-    'common.preview': 'Preview',
-    'common.total': 'Total',
-    'crud.newItem': 'New {{name}}',
-    'crud.editItem': 'Edit {{name}}',
-    'crud.deleteConfirm': 'Delete {{name}}?',
-    'crud.deleteMessage': 'This action cannot be undone.',
-    'crud.created': '{{name}} created',
-    'crud.updated': '{{name}} updated',
-    'crud.deleted': '{{name}} deleted',
-    'crud.noItems': 'No {{namePlural}} yet.',
-    'auth.login.title': 'Sign in',
-    'auth.login.subtitle': 'Enter your credentials to access your account',
-    'auth.login.emailLabel': 'Email',
-    'auth.login.passwordLabel': 'Password',
-    'auth.login.submit': 'Sign in',
-    'auth.login.forgotPassword': 'Forgot password?',
-    'auth.login.noAccount': "Don't have an account?",
-    'auth.login.signUpLink': 'Sign up',
-    'auth.signup.title': 'Create account',
-    'auth.signup.submit': 'Create account',
-    'auth.signup.hasAccount': 'Already have an account?',
-    'auth.signup.signInLink': 'Sign in',
-    'auth.setPassword.recoveryTitle': 'Choose a new password',
-    'auth.setPassword.recoverySubtitle': 'Set a new password to get back into your account.',
-    'auth.setPassword.welcomeTitle': 'Welcome to {{appName}}',
-    'auth.setPassword.welcomeSubtitle': 'Choose a password to finish setting up your access.',
-    'auth.setPassword.newPassword': 'New password',
-    'auth.setPassword.confirmPassword': 'Confirm password',
-    'auth.setPassword.submit': 'Save password',
-    'auth.setPassword.saving': 'Saving...',
-    'auth.setPassword.tooShort': 'Password must be at least 8 characters.',
-    'auth.setPassword.mismatch': 'Passwords do not match.',
-    'auth.setPassword.checking': 'Checking your link...',
-    'auth.setPassword.expiredTitle': 'This link has expired',
-    'auth.setPassword.expiredSubtitle': 'Reset links can only be used once. Enter your e-mail and we will send a new one.',
-    'auth.setPassword.email': 'E-mail',
-    'auth.setPassword.sendNewLink': 'Send new link',
-    'auth.setPassword.sending': 'Sending...',
-    'auth.setPassword.sent': 'Check your inbox — a new link is on the way.',
-    'auth.setPassword.backToLogin': 'Back to sign in',
-    'settings.title': 'Settings',
-    'settings.company': 'Company',
-    'settings.branding': 'Branding',
-    'settings.security': 'Security',
-    'settings.sites': 'Sites',
-    'settings.team': 'Team',
-    'settings.billing': 'Billing',
-    'settings.locations': 'Locations',
-    'billing.title': 'Plans & Billing',
-    'billing.currentPlan': 'Current Plan',
-    'billing.upgrade': 'Upgrade',
-    'billing.manage': 'Manage Subscription',
-  },
-  'pt-BR': {
-    'common.save': 'Salvar',
-    'common.saveChanges': 'Salvar Alterações',
-    'common.saving': 'Salvando...',
-    'common.cancel': 'Cancelar',
-    'common.delete': 'Excluir',
-    'common.edit': 'Editar',
-    'common.close': 'Fechar',
-    'common.confirm': 'Confirmar',
-    'common.discard': 'Descartar',
-    'common.back': 'Voltar',
-    'common.formIncomplete': 'Preencha os campos obrigatórios antes de salvar.',
-    'connectors.title': 'Integrações',
-    'connectors.subtitle': 'Conecte provedores externos a este módulo.',
-    'connectors.connected': 'Conectado',
-    'connectors.notConnected': 'Não conectado',
-    'connectors.connect': 'Conectar',
-    'connectors.disconnect': 'Desconectar',
-    'connectors.test': 'Testar',
-    'connectors.save': 'Salvar conexão',
-    'connectors.testing': 'Testando…',
-    'connectors.saving': 'Salvando…',
-    'connectors.empty': 'Nenhuma integração disponível para este módulo ainda.',
-    'connectors.configure': 'Configurar',
-    'connectors.hubSubtitle': 'Aplicativos, assistentes e provedores ligados a esta organização.',
-    'connectors.add': 'Adicionar conector',
-    'connectors.addSubtitle': 'Integrações disponíveis no Fayz para esta organização.',
-    'connectors.search': 'Buscar integração…',
-    'connectors.noneFound': 'Nenhuma integração encontrada para “{{query}}”.',
-    'connectors.viewAll': 'Ver todos os conectores',
-    'connectors.groupMine': 'Nesta organização',
-    'connectors.groupOffered': 'Oferecidos pelo Fayz',
-    'connectors.docs': 'Documentação do provedor',
-    'connectors.builtIn': 'nativo',
-    'connectors.partOfApp': 'faz parte do app',
-    'connectors.plane.agentic': 'Assistente',
-    'connectors.plane.agentic.desc': 'O assistente usa as ferramentas do provedor na hora. Nada é copiado.',
-    'connectors.plane.sync': 'Sincronização',
-    'connectors.plane.sync.desc': 'Uma esteira mantém uma cópia dos dados dentro do app.',
-    'connectors.plane.recommended': 'recomendado',
-    'connectors.plane.undecided': 'O modo desta integração é definido pelo Fayz quando ela for ligada.',
-    'connectors.plane.switched': 'Modo alterado',
-    'connectors.plane.lockedHint': 'Esta conexão não troca de modo depois de feita — desconecte e conecte de novo.',
-    'connectors.direction.inbound': 'entrada',
-    'connectors.direction.outbound': 'saída',
-    'connectors.state.connected': 'conectado',
-    'connectors.state.ready': 'pronto para conectar',
-    'connectors.state.catalog': 'disponível no Fayz',
-    'connectors.state.soon': 'em breve',
-    'connectors.journey.what': 'O que ele faz',
-    'connectors.journey.how': 'Como ele resolve',
-    'connectors.journey.authorize': 'Autorizar',
-    'connectors.journey.access': 'Acesso',
-    'connectors.journey.after': 'Depois de conectado',
-    'connectors.after.agentic': 'Essas ferramentas já estão à mão do assistente.',
-    'connectors.after.willAgentic': 'O assistente ganha as ferramentas do provedor; nenhuma cópia dos dados é feita.',
-    'connectors.after.willSync': 'Uma esteira passa a manter esses dados em acordo, com de-para e histórico.',
-    'connectors.tools': 'Ferramentas do assistente',
-    'connectors.entitiesCount': 'alcança {{count}} tipos de registro',
-    'connectors.entitiesList': 'Registros: {{list}}',
-    'connectors.capabilitiesUnknown': 'Este conector ainda não publicou o que ele alcança.',
-    'connectors.readOnly': 'somente leitura',
-    'connectors.readWrite': 'leitura e escrita',
-    'connectors.needsPlugin': 'O Fayz tem essa integração pronta, mas este app não tem o plugin que hospeda ela.',
-    'connectors.soonBody': 'O Fayz lista este provedor, mas a integração ainda não foi ligada.',
-    'connectors.connectedOn': 'Conectado em {{date}}',
-    'connectors.lastUsed': 'usado {{when}}',
-    'connectors.neverUsed': 'ainda não usado',
-    'connectors.grantedByOther': 'autorizado por outra pessoa da equipe',
-    'connectors.revokeConfirm': 'Desconectar {{name}}? Ele perde o acesso imediatamente.',
-    'connectors.filter.all': 'Tudo',
-    'connectors.filter.connected': 'Conectados',
-    'connectors.filter.agentic': 'Assistente',
-    'connectors.filter.sync': 'Sincronização',
-    'connectors.emptyTitle': 'Nenhum conector',
-    'connectors.emptyBody': 'Conecte um provedor, ou autorize um assistente externo, e ele aparece aqui.',
-    'connectors.noProject': 'Conectores indisponíveis',
-    'connectors.noProjectBody': 'Este app não está ligado a um projeto Fayz.',
-    'connectors.noOrg': 'Sem organização',
-    'connectors.noOrgBody': 'Escolha uma organização para ver as conexões dela.',
-    'saveBar.unsaved': 'Alterações não salvas',
-    'common.add': 'Adicionar',
-    'common.loading': 'Carregando...',
-    'common.error': 'Algo deu errado',
-    'common.noResults': 'Nenhum resultado encontrado.',
-    'common.search': 'Buscar',
-    'common.actions': 'Ações',
-    'common.continue': 'Continuar',
-    'common.done': 'Concluído',
-    'common.yes': 'Sim',
-    'common.no': 'Não',
-    'common.active': 'Ativo',
-    'common.inactive': 'Inativo',
-    'common.overview': 'Visão Geral',
-    'common.settings': 'Configurações',
-    'common.plugins': 'Plugins',
-    'common.new': 'Novo',
-    'common.filter': 'Filtrar',
-    'common.export': 'Exportar',
-    'common.import': 'Importar',
-    'common.preview': 'Pré-visualizar',
-    'common.total': 'Total',
-    'crud.newItem': 'Novo {{name}}',
-    'crud.editItem': 'Editar {{name}}',
-    'crud.deleteConfirm': 'Excluir {{name}}?',
-    'crud.deleteMessage': 'Esta ação não pode ser desfeita.',
-    'crud.created': '{{name}} criado',
-    'crud.updated': '{{name}} atualizado',
-    'crud.deleted': '{{name}} excluído',
-    'crud.noItems': 'Nenhum {{namePlural}} ainda.',
-    'auth.login.title': 'Entrar',
-    'auth.login.subtitle': 'Digite suas credenciais para acessar sua conta',
-    'auth.login.emailLabel': 'E-mail',
-    'auth.login.passwordLabel': 'Senha',
-    'auth.login.submit': 'Entrar',
-    'auth.login.forgotPassword': 'Esqueceu a senha?',
-    'auth.login.noAccount': 'Não tem uma conta?',
-    'auth.login.signUpLink': 'Cadastrar',
-    'auth.signup.title': 'Criar conta',
-    'auth.signup.submit': 'Criar conta',
-    'auth.signup.hasAccount': 'Já tem uma conta?',
-    'auth.signup.signInLink': 'Entrar',
-    'auth.setPassword.recoveryTitle': 'Escolha uma nova senha',
-    'auth.setPassword.recoverySubtitle': 'Defina uma nova senha para voltar a acessar sua conta.',
-    'auth.setPassword.welcomeTitle': 'Bem-vindo ao {{appName}}',
-    'auth.setPassword.welcomeSubtitle': 'Escolha uma senha para terminar de configurar seu acesso.',
-    'auth.setPassword.newPassword': 'Nova senha',
-    'auth.setPassword.confirmPassword': 'Confirmar senha',
-    'auth.setPassword.submit': 'Salvar senha',
-    'auth.setPassword.saving': 'Salvando...',
-    'auth.setPassword.tooShort': 'A senha precisa ter no mínimo 8 caracteres.',
-    'auth.setPassword.mismatch': 'As senhas não conferem.',
-    'auth.setPassword.checking': 'Verificando seu link...',
-    'auth.setPassword.expiredTitle': 'Este link expirou',
-    'auth.setPassword.expiredSubtitle': 'Links de acesso só funcionam uma vez. Informe seu e-mail e enviamos um novo.',
-    'auth.setPassword.email': 'E-mail',
-    'auth.setPassword.sendNewLink': 'Enviar novo link',
-    'auth.setPassword.sending': 'Enviando...',
-    'auth.setPassword.sent': 'Confira sua caixa de entrada — o novo link está a caminho.',
-    'auth.setPassword.backToLogin': 'Voltar para o login',
-    'settings.title': 'Configurações',
-    'settings.company': 'Empresa',
-    'settings.branding': 'Identidade Visual',
-    'settings.security': 'Segurança',
-    'settings.sites': 'Sites',
-    'settings.team': 'Equipe',
-    'settings.billing': 'Faturamento',
-    'settings.locations': 'Localizações',
-    'billing.title': 'Planos e Faturamento',
-    'billing.currentPlan': 'Plano Atual',
-    'billing.upgrade': 'Fazer Upgrade',
-    'billing.manage': 'Gerenciar Assinatura',
-  },
-}
-
-// Global translation registry — plugins merge their locales here so keys resolve
-// regardless of which shell mounts the I18nProvider.
-let _globalTranslations: Record<string, Record<string, string>> = {}
-
-export function registerTranslations(translations?: Record<string, Record<string, string>>): void {
-  if (!translations) return
-  _globalTranslations = mergeTranslations(_globalTranslations, translations)
-}
-
-export function mergeTranslations(
-  base: Record<string, Record<string, string>>,
-  ...overrides: Array<Record<string, Record<string, string>> | undefined>
-): Record<string, Record<string, string>> {
-  const result = { ...base }
-  for (const override of overrides) {
-    if (!override) continue
-    for (const [locale, translations] of Object.entries(override)) {
-      result[locale] = { ...(result[locale] ?? {}), ...translations }
-    }
-  }
-  return result
-}
-
-// Seed the global fallback with core's own translations + the shared shell /
-// CRUD / framework translations (extracted from saas-core's central i18n), so
-// the native CRUD engine, framework UI and de-bridged plugins resolve their
-// keys even under a host shell that does not mount @fayz-ai/core's I18nProvider.
-registerTranslations(coreTranslations)
-registerTranslations({ en: shellTranslationsEn })
-
-// ---------------------------------------------------------------------------
-// Lazy shell locales. Only 'en' (the fallback) ships eagerly; other locales
-// load on demand when the app switches to them (setCurrentLocale) or when the
-// app awaits preloadLocale before rendering. Keys resolve through the 'en'
-// fallback until the locale chunk arrives, then listeners re-render.
-// ---------------------------------------------------------------------------
-
-const _lazyShellLocales: Record<string, () => Promise<Record<string, string>>> = {
-  'pt-BR': () => import('./shell-translations.pt-br').then((m) => m.shellTranslationsPtBr),
-}
-const _loadedShellLocales = new Set<string>(['en'])
-const _pendingShellLocales = new Map<string, Promise<void>>()
-
-/**
- * Ensure a lazily-split shell locale is loaded and registered. Resolves
- * immediately for unknown/already-loaded locales. setCurrentLocale calls this
- * fire-and-forget; apps that must avoid an English flash on first paint can
- * `await preloadLocale('pt-BR')` before rendering.
- */
-export function preloadLocale(locale: string): Promise<void> {
-  if (_loadedShellLocales.has(locale)) return Promise.resolve()
-  const loader = _lazyShellLocales[locale]
-  if (!loader) return Promise.resolve()
-  let pending = _pendingShellLocales.get(locale)
-  if (!pending) {
-    pending = loader().then((translations) => {
-      _loadedShellLocales.add(locale)
-      _pendingShellLocales.delete(locale)
-      registerTranslations({ [locale]: translations })
-      _i18nVersion++
-      _localeListeners.forEach((listener) => listener())
-    })
-    _pendingShellLocales.set(locale, pending)
-  }
-  return pending
-}