@datatechsolutions/tympan 0.3.0 → 0.3.1

package/src/internal/messages/platform.ts

@@ -0,0 +1,63 @@
+// Copy of the "platform" group (wave 2/4). One namespace per component, English,
+// Brazilian Portuguese and Spanish. Merged into `Messages` by ../messages.ts.
+
+export interface PlatformMessages {
+  formatters: { placeholder: string }
+  swipeRow: {
+    actionsFor: (row: string) => string
+    delete: string
+    archive: string
+    edit: string
+    favourite: string
+  }
+  pullToRefresh: { refreshing: string }
+  glassCheck: { label: string; notApplicable: string }
+}
+
+export const platformEn: PlatformMessages = {
+  formatters: { placeholder: 'not informed' },
+  swipeRow: {
+    actionsFor: (row) => `Actions for ${row}`,
+    delete: 'Delete',
+    archive: 'Archive',
+    edit: 'Edit',
+    favourite: 'Favourite',
+  },
+  pullToRefresh: { refreshing: 'Refreshing' },
+  glassCheck: {
+    label: 'Glass check',
+    notApplicable: 'Surfaces are opaque in this display mode, so the check does not apply.',
+  },
+}
+
+export const platformPtBR: PlatformMessages = {
+  formatters: { placeholder: 'não informado' },
+  swipeRow: {
+    actionsFor: (row) => `Ações de ${row}`,
+    delete: 'Excluir',
+    archive: 'Arquivar',
+    edit: 'Editar',
+    favourite: 'Favoritar',
+  },
+  pullToRefresh: { refreshing: 'Atualizando' },
+  glassCheck: {
+    label: 'Teste do vidro',
+    notApplicable: 'As superfícies ficam opacas neste modo de exibição, então o teste não se aplica.',
+  },
+}
+
+export const platformEs: PlatformMessages = {
+  formatters: { placeholder: 'no informado' },
+  swipeRow: {
+    actionsFor: (row) => `Acciones de ${row}`,
+    delete: 'Eliminar',
+    archive: 'Archivar',
+    edit: 'Editar',
+    favourite: 'Marcar como favorito',
+  },
+  pullToRefresh: { refreshing: 'Actualizando' },
+  glassCheck: {
+    label: 'Prueba del vidrio',
+    notApplicable: 'Las superficies son opacas en este modo de visualización, así que la prueba no se aplica.',
+  },
+}

package/src/internal/messages/plural.ts

@@ -0,0 +1,24 @@
+// Locale-bound number and plural helpers for the shipped catalogues. Each
+// catalogue formats its own numbers (digits, grouping) and picks plural forms
+// with Intl.PluralRules instead of string concatenation.
+
+export interface CountWords {
+  one: string
+  other: string
+  /** Optional CLDR categories for languages that have them. */
+  zero?: string
+  two?: string
+  few?: string
+  many?: string
+}
+
+export function speaker(language: string) {
+  const rules = new Intl.PluralRules(language)
+  const numbers = new Intl.NumberFormat(language)
+  return {
+    /** Formats a number in the catalogue's language. */
+    n: (value: number) => numbers.format(value),
+    /** The word for `count`, by CLDR plural category. */
+    word: (count: number, words: CountWords) => words[rules.select(count) as keyof CountWords] ?? words.other,
+  }
+}

package/src/internal/messages/shell.ts

@@ -0,0 +1,144 @@
+// Copy of the "shell" group (wave 4 research shell). One namespace per
+// component, English and Brazilian Portuguese. Merged into `Messages` by
+// ../messages.ts.
+
+export type StageStatus = 'done' | 'current' | 'upcoming' | 'attention'
+
+export interface ShellMessages {
+  actionBar: {
+    /** Landmark name of the bar. */
+    label: string
+    more: string
+    /** Accessible name of an item's menu chevron. */
+    openMenu: (item: string) => string
+    /** Count in words, appended to the item name. */
+    count: (n: number) => string
+    loading: string
+    /** Skip-link text targeting the bar. */
+    skipTo: string
+    /** Entry of the tab bar's "more" menu that opens the rail drawer. */
+    allSections: string
+    confirm: string
+    cancel: string
+    /** Capped badge; receives the formatted cap (for example "99"). */
+    capped: (cap: string) => string
+  }
+  rail: {
+    label: string
+    openNavigation: string
+    closeNavigation: string
+    count: (n: number) => string
+    capped: (cap: string) => string
+  }
+  pageTrail: { label: string }
+  evidencePanel: { close: string; resize: string }
+  stageStrip: { status: Record<StageStatus, string> }
+  attentionList: {
+    empty: string
+    seeAll: string
+    actionName: (action: string, title: string) => string
+    /** Visually hidden suffix that makes an action's name unique (": TAMM"). */
+    actionTarget: (title: string) => string
+  }
+  activityFeed: { empty: string }
+  phaseBar: { part: (label: string, value: string) => string; empty: string; named: (label: string, parts: string) => string }
+}
+
+export const shellEn: ShellMessages = {
+  actionBar: {
+    label: 'Actions',
+    more: 'More',
+    openMenu: (item) => `Open the menu of ${item}`,
+    count: (n) => (new Intl.PluralRules('en').select(n) === 'one' ? `${n} pending` : `${n} pending`),
+    loading: 'Loading actions',
+    skipTo: 'Skip to the action bar',
+    allSections: 'All sections',
+    confirm: 'Confirm',
+    capped: (cap) => `${cap}+`,
+    cancel: 'Cancel',
+  },
+  rail: {
+    label: 'Main',
+    openNavigation: 'Open navigation',
+    closeNavigation: 'Close navigation',
+    count: (n) => (new Intl.PluralRules('en').select(n) === 'one' ? `${n} pending` : `${n} pending`),
+    capped: (cap) => `${cap}+`,
+  },
+  pageTrail: { label: 'Breadcrumb' },
+  evidencePanel: { close: 'Close panel', resize: 'Resize panel' },
+  stageStrip: { status: { done: 'done', current: 'current', upcoming: 'upcoming', attention: 'needs attention' } },
+  attentionList: {
+    empty: 'Nothing needs you right now.',
+    seeAll: 'See all',
+    actionName: (action, title) => `${action}: ${title}`,
+    actionTarget: (title) => `: ${title}`,
+  },
+  activityFeed: { empty: 'No activity yet.' },
+  phaseBar: { part: (label, value) => `${label} ${value}`, empty: 'No data yet', named: (label, parts) => `${label}: ${parts}` },
+}
+
+export const shellPtBR: ShellMessages = {
+  actionBar: {
+    label: 'Ações',
+    more: 'Mais',
+    openMenu: (item) => `Abrir o menu de ${item}`,
+    count: (n) => (new Intl.PluralRules('pt-BR').select(n) === 'one' ? `${n} pendente` : `${n} pendentes`),
+    loading: 'Carregando as ações',
+    skipTo: 'Ir para a barra de ações',
+    allSections: 'Todas as seções',
+    confirm: 'Confirmar',
+    capped: (cap) => `${cap}+`,
+    cancel: 'Cancelar',
+  },
+  rail: {
+    label: 'Principal',
+    openNavigation: 'Abrir navegação',
+    closeNavigation: 'Fechar navegação',
+    count: (n) => (new Intl.PluralRules('pt-BR').select(n) === 'one' ? `${n} pendente` : `${n} pendentes`),
+    capped: (cap) => `${cap}+`,
+  },
+  pageTrail: { label: 'Trilha de navegação' },
+  evidencePanel: { close: 'Fechar painel', resize: 'Redimensionar painel' },
+  stageStrip: { status: { done: 'concluída', current: 'em curso', upcoming: 'a seguir', attention: 'pede atenção' } },
+  attentionList: {
+    empty: 'Nada precisa de você agora.',
+    seeAll: 'Ver tudo',
+    actionName: (action, title) => `${action}: ${title}`,
+    actionTarget: (title) => `: ${title}`,
+  },
+  activityFeed: { empty: 'Ainda não há atividade.' },
+  phaseBar: { part: (label, value) => `${label} ${value}`, empty: 'Ainda sem dados', named: (label, parts) => `${label}: ${parts}` },
+}
+
+export const shellEs: ShellMessages = {
+  actionBar: {
+    label: 'Acciones',
+    more: 'Más',
+    openMenu: (item) => `Abrir el menú de ${item}`,
+    count: (n) => (new Intl.PluralRules('es').select(n) === 'one' ? `${n} pendiente` : `${n} pendientes`),
+    loading: 'Cargando las acciones',
+    skipTo: 'Ir a la barra de acciones',
+    allSections: 'Todas las secciones',
+    confirm: 'Confirmar',
+    capped: (cap) => `${cap}+`,
+    cancel: 'Cancelar',
+  },
+  rail: {
+    label: 'Principal',
+    openNavigation: 'Abrir navegación',
+    closeNavigation: 'Cerrar navegación',
+    count: (n) => (new Intl.PluralRules('es').select(n) === 'one' ? `${n} pendiente` : `${n} pendientes`),
+    capped: (cap) => `${cap}+`,
+  },
+  pageTrail: { label: 'Ruta de navegación' },
+  evidencePanel: { close: 'Cerrar panel', resize: 'Redimensionar panel' },
+  stageStrip: { status: { done: 'concluida', current: 'en curso', upcoming: 'siguiente', attention: 'requiere atención' } },
+  attentionList: {
+    empty: 'Nada requiere su atención ahora.',
+    seeAll: 'Ver todo',
+    actionName: (action, title) => `${action}: ${title}`,
+    actionTarget: (title) => `: ${title}`,
+  },
+  activityFeed: { empty: 'Todavía no hay actividad.' },
+  phaseBar: { part: (label, value) => `${label} ${value}`, empty: 'Todavía sin datos', named: (label, parts) => `${label}: ${parts}` },
+}

package/src/internal/messages/showcase.ts

@@ -0,0 +1,12 @@
+// Copy of the "showcase" group (wave 2/4). One namespace per component, English
+// and Brazilian Portuguese. Merged into `Messages` by ../messages.ts.
+
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface ShowcaseMessages {}
+
+export const showcaseEn: ShowcaseMessages = {}
+
+export const showcasePtBR: ShowcaseMessages = {}
+
+/** Spanish (placeholder until translated: falls back to English). */
+export const showcaseEs: ShowcaseMessages = showcaseEn

package/src/internal/messages.ts

@@ -0,0 +1,335 @@
+// Default copy of the library. Components never hard-code strings: they read
+// this catalogue through `useMessages()`, and hosts override any entry through
+// `<TympanProvider messages={…}>` (for example from their own i18n adapter).
+
+import { formsAEn, formsAEs, formsAPtBR, type FormsAMessages } from './messages/forms-a'
+import { formsBEn, formsBEs, formsBPtBR, type FormsBMessages } from './messages/forms-b'
+import { overlaysNavEn, overlaysNavEs, overlaysNavPtBR, type OverlaysNavMessages } from './messages/overlays-nav'
+import { dataAEn, dataAEs, dataAPtBR, type DataAMessages } from './messages/data-a'
+import { dataBEn, dataBEs, dataBPtBR, type DataBMessages } from './messages/data-b'
+import { chartsGeoEn, chartsGeoEs, chartsGeoPtBR, type ChartsGeoMessages } from './messages/charts-geo'
+import { authBrandEn, authBrandEs, authBrandPtBR, type AuthBrandMessages } from './messages/auth-brand'
+import { platformEn, platformEs, platformPtBR, type PlatformMessages } from './messages/platform'
+import { showcaseEn, showcaseEs, showcasePtBR, type ShowcaseMessages } from './messages/showcase'
+import { shellEn, shellEs, shellPtBR, type ShellMessages } from './messages/shell'
+import { coreEs } from './messages/core-es'
+import { speaker } from './messages/plural'
+
+const en = speaker('en')
+const pt = speaker('pt-BR')
+
+export type ProofStateKey = 'proved' | 'pending' | 'refuted' | 'not_disclosed' | 'none'
+export type ErrorKind = 'generic' | 'network' | 'server' | 'permission' | 'not-found' | 'conflict'
+export type EmptyReason = 'no-data' | 'no-results' | 'offline'
+
+/** Group catalogues of waves 2 and 4 (see ./messages/). */
+export type GroupMessages = FormsAMessages & FormsBMessages & OverlaysNavMessages & DataAMessages & DataBMessages & ChartsGeoMessages & AuthBrandMessages & PlatformMessages & ShowcaseMessages & ShellMessages
+
+/** Wave 1 copy plus one interface per wave 2/4 group (see ./messages/). */
+export interface Messages
+  extends FormsAMessages, FormsBMessages, OverlaysNavMessages, DataAMessages, DataBMessages, ChartsGeoMessages, AuthBrandMessages, PlatformMessages, ShowcaseMessages, ShellMessages {
+  close: string
+  dismiss: string
+  loading: string
+  required: string
+  moreActions: string
+  inProgress: string
+  breadcrumbs: { label: string; backTo: (parent: string) => string; overflow: string }
+  link: { opensInNewTab: string }
+  textField: {
+    clear: string
+    showPassword: string
+    hidePassword: string
+    counter: (count: number, max: number) => string
+    overLimit: (count: number, max: number) => string
+  }
+  select: { placeholder: string; done: string }
+  notice: { toneWord: Record<'danger' | 'warning' | 'info' | 'success', string> }
+  empty: Record<EmptyReason, { title: string; description: string }> & { clearFilters: string; retry: string }
+  error: Record<ErrorKind, { title: string; message: string }> & {
+    retry: string
+    details: string
+    statusCode: (code: number) => string
+  }
+  pagination: {
+    navigation: string
+    previous: string
+    next: string
+    pageSize: string
+    range: (from: number, to: number, total: number) => string
+    page: (n: number) => string
+    pageOf: (n: number, count: number) => string
+  }
+  skipLink: string
+  status: Record<'pending' | 'approved' | 'rejected' | 'active' | 'inactive' | 'processing' | 'error' | 'success', string>
+  tag: { remove: (text: string) => string }
+  toast: { region: string; dismiss: string }
+  avatar: { open: (name: string) => string }
+  frame: {
+    navigation: string
+    openNavigation: string
+    closeNavigation: string
+    collapseNavigation: string
+    expandNavigation: string
+    loadingPage: string
+    closePanel: string
+  }
+  table: {
+    loading: string
+    selectAll: string
+    selectRow: (label: string) => string
+    empty: string
+    sortAscending: string
+    sortDescending: string
+  }
+  proof: Record<ProofStateKey, string> & {
+    provedBy: (who: string) => string
+    rule: (rule: string) => string
+  }
+  actor: { person: string; agent: string; system: string }
+}
+
+export const defaultMessages: Messages = {
+  ...formsAEn,
+  ...formsBEn,
+  ...overlaysNavEn,
+  ...dataAEn,
+  ...dataBEn,
+  ...chartsGeoEn,
+  ...authBrandEn,
+  ...platformEn,
+  ...showcaseEn,
+  ...shellEn,
+  close: 'Close',
+  dismiss: 'Dismiss',
+  loading: 'Loading',
+  required: 'required',
+  moreActions: 'More actions',
+  inProgress: 'In progress',
+  breadcrumbs: { label: 'Breadcrumb', backTo: (p) => `Back to ${p}`, overflow: 'Show hidden levels' },
+  link: { opensInNewTab: '(opens in a new tab)' },
+  textField: {
+    clear: 'Clear',
+    showPassword: 'Show password',
+    hidePassword: 'Hide password',
+    counter: (n, max) => `${en.n(n)} of ${en.n(max)} ${en.word(max, { one: 'character', other: 'characters' })}`,
+    overLimit: (n, max) =>
+      `${en.n(n)} of ${en.n(max)} ${en.word(max, { one: 'character', other: 'characters' })}, ${en.n(n - max)} over the limit`,
+  },
+  select: { placeholder: 'Select…', done: 'Done' },
+  notice: { toneWord: { danger: 'Error:', warning: 'Warning:', info: 'Information:', success: 'Success:' } },
+  empty: {
+    'no-data': { title: 'Nothing here yet', description: 'Items appear here once they are added.' },
+    'no-results': { title: 'No records match these filters', description: 'Change the filters or clear them to see every record.' },
+    offline: { title: 'You are offline', description: 'Check the connection and try again.' },
+    clearFilters: 'Clear filters',
+    retry: 'Try again',
+  },
+  error: {
+    generic: { title: 'Something went wrong', message: 'The content could not be loaded.' },
+    network: { title: 'Connection problem', message: 'The server could not be reached. Check the connection and try again.' },
+    server: { title: 'The server failed', message: 'The server could not complete the request. Try again in a moment.' },
+    permission: { title: 'No access', message: 'Your role does not allow you to see this content.' },
+    'not-found': { title: 'Not found', message: 'This item does not exist or was removed.' },
+    conflict: { title: 'Changed by someone else', message: 'Someone changed this item before you. Reload it to see the latest version.' },
+    retry: 'Try again',
+    details: 'Technical details',
+    statusCode: (code) => `Status ${code}`,
+  },
+  pagination: {
+    navigation: 'Pagination',
+    previous: 'Previous',
+    next: 'Next',
+    pageSize: 'Items per page',
+    range: (from, to, total) => `${en.n(from)} to ${en.n(to)} of ${en.n(total)}`,
+    page: (n) => `Page ${en.n(n)}`,
+    pageOf: (n, count) => `Page ${en.n(n)} of ${en.n(count)}`,
+  },
+  skipLink: 'Skip to main content',
+  status: {
+    pending: 'Pending',
+    approved: 'Approved',
+    rejected: 'Rejected',
+    active: 'Active',
+    inactive: 'Inactive',
+    processing: 'Processing',
+    error: 'Error',
+    success: 'Success',
+  },
+  tag: { remove: (text) => `Remove ${text}` },
+  toast: { region: 'Notifications', dismiss: 'Dismiss notification' },
+  avatar: { open: (name) => `Open profile of ${name}` },
+  frame: {
+    navigation: 'Main',
+    openNavigation: 'Open navigation',
+    closeNavigation: 'Close navigation',
+    collapseNavigation: 'Collapse navigation',
+    expandNavigation: 'Expand navigation',
+    loadingPage: 'Loading the page',
+    closePanel: 'Close panel',
+  },
+  table: {
+    loading: 'Loading the list',
+    selectAll: 'Select all rows',
+    selectRow: (label) => `Select ${label}`,
+    empty: 'No rows to show',
+    sortAscending: 'sorted ascending',
+    sortDescending: 'sorted descending',
+  },
+  proof: {
+    proved: 'proved',
+    pending: 'pending',
+    refuted: 'refuted',
+    not_disclosed: 'not disclosed',
+    none: 'no proof',
+    provedBy: (who) => `by ${who}`,
+    rule: (rule) => `rule ${rule}`,
+  },
+  actor: { person: 'person', agent: 'agent', system: 'system' },
+}
+
+/** Portuguese (Brazil) catalogue, the platform's first language. */
+export const messagesPtBR: Messages = {
+  ...formsAPtBR,
+  ...formsBPtBR,
+  ...overlaysNavPtBR,
+  ...dataAPtBR,
+  ...dataBPtBR,
+  ...chartsGeoPtBR,
+  ...authBrandPtBR,
+  ...platformPtBR,
+  ...showcasePtBR,
+  ...shellPtBR,
+  close: 'Fechar',
+  dismiss: 'Dispensar',
+  loading: 'Carregando',
+  required: 'obrigatório',
+  moreActions: 'Mais ações',
+  inProgress: 'Em andamento',
+  breadcrumbs: { label: 'Trilha de navegação', backTo: (p) => `Voltar para ${p}`, overflow: 'Mostrar níveis ocultos' },
+  link: { opensInNewTab: '(abre em nova aba)' },
+  textField: {
+    clear: 'Limpar',
+    showPassword: 'Mostrar senha',
+    hidePassword: 'Ocultar senha',
+    counter: (n, max) => `${pt.n(n)} de ${pt.n(max)} ${pt.word(max, { one: 'caractere', other: 'caracteres' })}`,
+    overLimit: (n, max) =>
+      `${pt.n(n)} de ${pt.n(max)} ${pt.word(max, { one: 'caractere', other: 'caracteres' })}, ${pt.n(n - max)} acima do limite`,
+  },
+  select: { placeholder: 'Selecione…', done: 'Concluir' },
+  notice: { toneWord: { danger: 'Erro:', warning: 'Atenção:', info: 'Informação:', success: 'Sucesso:' } },
+  empty: {
+    'no-data': { title: 'Ainda não há nada aqui', description: 'Os itens aparecem aqui quando forem adicionados.' },
+    'no-results': { title: 'Nenhum registro com esses filtros', description: 'Mude os filtros ou limpe-os para ver todos os registros.' },
+    offline: { title: 'Você está sem conexão', description: 'Confira a conexão e tente de novo.' },
+    clearFilters: 'Limpar filtros',
+    retry: 'Tentar de novo',
+  },
+  error: {
+    generic: { title: 'Algo deu errado', message: 'O conteúdo não pôde ser carregado.' },
+    network: { title: 'Problema de conexão', message: 'Não foi possível falar com o servidor. Confira a conexão e tente de novo.' },
+    server: { title: 'O servidor falhou', message: 'O servidor não concluiu o pedido. Tente de novo em instantes.' },
+    permission: { title: 'Sem acesso', message: 'Seu papel não permite ver este conteúdo.' },
+    'not-found': { title: 'Não encontrado', message: 'Este item não existe ou foi removido.' },
+    conflict: { title: 'Alterado por outra pessoa', message: 'Alguém alterou este item antes de você. Recarregue para ver a versão atual.' },
+    retry: 'Tentar de novo',
+    details: 'Detalhes técnicos',
+    statusCode: (code) => `Código ${code}`,
+  },
+  pagination: {
+    navigation: 'Paginação',
+    previous: 'Anterior',
+    next: 'Próxima',
+    pageSize: 'Itens por página',
+    range: (from, to, total) => `${pt.n(from)} a ${pt.n(to)} de ${pt.n(total)}`,
+    page: (n) => `Página ${pt.n(n)}`,
+    pageOf: (n, count) => `Página ${pt.n(n)} de ${pt.n(count)}`,
+  },
+  skipLink: 'Ir para o conteúdo',
+  status: {
+    pending: 'Pendente',
+    approved: 'Aprovado',
+    rejected: 'Rejeitado',
+    active: 'Ativo',
+    inactive: 'Inativo',
+    processing: 'Processando',
+    error: 'Erro',
+    success: 'Sucesso',
+  },
+  tag: { remove: (text) => `Remover ${text}` },
+  toast: { region: 'Notificações', dismiss: 'Dispensar notificação' },
+  avatar: { open: (name) => `Abrir perfil de ${name}` },
+  frame: {
+    navigation: 'Principal',
+    openNavigation: 'Abrir navegação',
+    closeNavigation: 'Fechar navegação',
+    collapseNavigation: 'Recolher navegação',
+    expandNavigation: 'Expandir navegação',
+    loadingPage: 'Carregando a página',
+    closePanel: 'Fechar painel',
+  },
+  table: {
+    loading: 'Carregando a lista',
+    selectAll: 'Selecionar todas as linhas',
+    selectRow: (label) => `Selecionar ${label}`,
+    empty: 'Nenhuma linha para mostrar',
+    sortAscending: 'em ordem crescente',
+    sortDescending: 'em ordem decrescente',
+  },
+  proof: {
+    proved: 'provada',
+    pending: 'pendente',
+    refuted: 'refutada',
+    not_disclosed: 'não informada',
+    none: 'sem prova',
+    provedBy: (who) => `por ${who}`,
+    rule: (rule) => `regra ${rule}`,
+  },
+  actor: { person: 'pessoa', agent: 'agente', system: 'sistema' },
+}
+
+export const messagesEs: Messages = {
+  ...formsAEs,
+  ...formsBEs,
+  ...overlaysNavEs,
+  ...dataAEs,
+  ...dataBEs,
+  ...chartsGeoEs,
+  ...authBrandEs,
+  ...platformEs,
+  ...showcaseEs,
+  ...shellEs,
+  ...coreEs,
+}
+
+/** The wave-1 part of the catalogue (the keys not owned by a group). */
+export type CoreMessages = Omit<Messages, keyof GroupMessages>
+
+/** Catalogues shipped as defaults. Other locales fall back to English copy with locale-aware formatting. */
+export const shippedCatalogues = { en: defaultMessages, 'pt-BR': messagesPtBR, es: messagesEs } as const
+
+/** Default catalogue for a BCP 47 locale: Portuguese and Spanish by language subtag, English otherwise. */
+export function catalogueForLocale(locale: string | undefined): Messages {
+  const language = (locale ?? 'en').toLowerCase().split(/[-_]/)[0]
+  return language === 'pt' ? messagesPtBR : language === 'es' ? messagesEs : defaultMessages
+}
+
+type DeepPartial<T> = { [K in keyof T]?: T[K] extends (...args: never[]) => unknown ? T[K] : T[K] extends object ? DeepPartial<T[K]> : T[K] }
+export type MessageOverrides = DeepPartial<Messages>
+
+function isPlainObject(v: unknown): v is Record<string, unknown> {
+  return !!v && typeof v === 'object' && !Array.isArray(v)
+}
+
+export function mergeMessages(base: Messages, overrides?: MessageOverrides): Messages {
+  if (!overrides) return base
+  const walk = (a: Record<string, unknown>, b: Record<string, unknown>): Record<string, unknown> => {
+    const out: Record<string, unknown> = { ...a }
+    for (const [k, v] of Object.entries(b)) {
+      if (v === undefined) continue
+      out[k] = isPlainObject(v) && isPlainObject(a[k]) ? walk(a[k] as Record<string, unknown>, v) : v
+    }
+    return out
+  }
+  return walk(base as unknown as Record<string, unknown>, overrides as Record<string, unknown>) as unknown as Messages
+}