@celke/kole-react 0.4.1 → 0.6.0

package/dist/i18n/contexto.d.ts

@@ -0,0 +1,15 @@
+import type { Idioma } from './idiomas.js';
+import { type Textos } from './pt-BR.js';
+interface ValorIdioma {
+    idioma: Idioma;
+    textos: Textos;
+}
+export declare const ContextoIdioma: import("react").Context<ValorIdioma>;
+/**
+ * O dicionário do idioma ativo. Fora de um `ProvedorPreferencias` (ou
+ * `ProvedorUi`), devolve o pt-BR: os componentes funcionam sozinhos.
+ */
+export declare function useTextos(): Textos;
+/** O idioma ativo (`pt-BR` fora do provedor): para formatar datas e números. */
+export declare function useIdioma(): Idioma;
+export {};

package/dist/i18n/en.d.ts

@@ -0,0 +1,3 @@
+import type { Textos } from './pt-BR.js';
+/** Textos da biblioteca em inglês (mesmo formato do pt-BR). */
+export declare const textosEn: Textos;

package/dist/i18n/es.d.ts

@@ -0,0 +1,3 @@
+import type { Textos } from './pt-BR.js';
+/** Textos da biblioteca em espanhol (mesmo formato do pt-BR). */
+export declare const textosEs: Textos;

package/dist/i18n/idiomas.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Idiomas da biblioteca e as peças sem React do multi-idioma: interpolação,
+ * plural e formatadores `Intl` com cache por idioma.
+ */
+/** Idiomas com dicionário pronto na biblioteca. */
+export type IdiomaPadrao = 'pt-BR' | 'en' | 'es';
+/**
+ * Idioma ativo. Além dos três prontos, o sistema pode acrescentar outro (ex.:
+ * `'fr'`) passando os textos dele em `textos` do `ProvedorPreferencias`; o que
+ * faltar sai em pt-BR.
+ */
+export type Idioma = IdiomaPadrao | (string & {});
+export declare const IDIOMAS_PADRAO: readonly IdiomaPadrao[];
+/** Formas do plural (categorias do `Intl.PluralRules`); `other` é obrigatória e serve de reserva. */
+export interface Plural {
+    zero?: string;
+    one?: string;
+    two?: string;
+    few?: string;
+    many?: string;
+    other: string;
+}
+/** Locale do `Intl` para o idioma (`en` → `en-US`, `es` → `es-ES`; os outros, como vierem). */
+export declare function localeDe(idioma: Idioma): string;
+/** `'Página {atual} de {total}'` + `{ atual: 2, total: 9 }` → `'Página 2 de 9'`. Chave sem valor fica como está. */
+export declare function interpolar(modelo: string, valores?: Record<string, string | number>): string;
+/** `Intl.NumberFormat` do idioma, criado uma vez por combinação de opções. */
+export declare function formatoNumero(idioma: Idioma, opcoes?: Intl.NumberFormatOptions): Intl.NumberFormat;
+/** `Intl.DateTimeFormat` do idioma, criado uma vez por combinação de opções. */
+export declare function formatoData(idioma: Idioma, opcoes?: Intl.DateTimeFormatOptions): Intl.DateTimeFormat;
+/** `Intl.ListFormat` (`a, b e c` · `a, b and c` · `a, b y c`). */
+export declare function formatoLista(idioma: Idioma, tipo?: 'conjunction' | 'disjunction'): Intl.ListFormat;
+/**
+ * A forma certa do plural para `n`, já com `{n}` (formatado no idioma) e os
+ * outros valores trocados: `{ one: '{n} item', other: '{n} itens' }`.
+ */
+export declare function pluralizar(idioma: Idioma, n: number, formas: Plural, valores?: Record<string, string | number>): string;
+/** Os 7 dias da semana, começando no domingo, no formato pedido (`short` = `dom.`/`Sun`). */
+export declare function diasDaSemana(idioma: Idioma, formato?: 'narrow' | 'short' | 'long'): string[];
+/** Os 12 meses (`long` = janeiro/January). */
+export declare function mesesDoAno(idioma: Idioma, formato?: 'narrow' | 'short' | 'long'): string[];

package/dist/i18n/pt-BR.d.ts

@@ -0,0 +1,545 @@
+import type { Plural } from './idiomas.js';
+/**
+ * Textos da biblioteca em português do Brasil: a fonte da verdade. `en.ts` e
+ * `es.ts` têm o mesmo formato (faltar chave é erro de tipo). `{nome}` é
+ * trocado pelo valor; os objetos com `one`/`other` são plurais.
+ */
+export declare const textosPtBR: {
+    idioma: {
+        /** O nome do idioma no próprio idioma (aparece no seletor). */
+        nome: string;
+        seletor: string;
+        atual: string;
+    };
+    comum: {
+        fechar: string;
+        cancelar: string;
+        confirmar: string;
+        salvar: string;
+        voltar: string;
+        remover: string;
+        excluir: string;
+        renomear: string;
+        adicionar: string;
+        aplicar: string;
+        buscar: string;
+        buscarReticencias: string;
+        buscando: string;
+        buscandoReticencias: string;
+        carregando: string;
+        carregandoReticencias: string;
+        selecione: string;
+        limparSelecao: string;
+        anterior: string;
+        proximo: string;
+        hoje: string;
+        ontem: string;
+        amanha: string;
+        sim: string;
+        nao: string;
+        copiar: string;
+        copiado: string;
+        naoFoiPossivelCopiar: string;
+        copiaBloqueada: string;
+        tentarDeNovo: string;
+        tentarNovamente: string;
+        detalhes: string;
+        expandir: string;
+        recolher: string;
+        temaClaro: string;
+        temaEscuro: string;
+        usarTemaClaro: string;
+        usarTemaEscuro: string;
+        menuPrincipal: string;
+        campoObrigatorio: string;
+        opcoes: string;
+        opcoesDe: string;
+        ok: string;
+    };
+    estados: {
+        vazioTitulo: string;
+        carregandoRegistros: string;
+        erroTitulo: string;
+        erroDescricao: string;
+    };
+    validacao: {
+        telefoneFixo: string;
+        telefoneCelular: string;
+        telefoneIncompleto: string;
+        cpfIncompleto: string;
+        cpfInvalido: string;
+        cnpjIncompleto: string;
+        cnpjInvalido: string;
+        cpfCnpjIncompleto: string;
+        emailInvalido: string;
+        cepIncompleto: string;
+        placaInvalida: string;
+        renavam: string;
+        chassiIncompleto: string;
+        chassiInvalido: string;
+        cnhIncompleta: string;
+        cnhInvalida: string;
+        imeiIncompleto: string;
+        imeiInvalido: string;
+        horaInvalida: string;
+        dataInvalida: string;
+        dataHoraInvalida: string;
+        /** Aviso do campo quando o valor não passa na regra mas é mantido. */
+        mantido: string;
+    };
+    campos: {
+        placeholderCpfCnpj: string;
+        placeholderChassi: string;
+        placeholderEmail: string;
+    };
+    senha: {
+        minimo: string;
+        minuscula: string;
+        maiuscula: string;
+        digito: string;
+        simbolo: string;
+        fraca: string;
+        media: string;
+        forte: string;
+        capsLock: string;
+        mostrar: string;
+        ocultar: string;
+        forca: string;
+    };
+    tempo: {
+        agora: string;
+        ontem: string;
+        amanha: string;
+        /** `{quanto}` = "5 min", "2 h", "3 dias"… */
+        passado: string;
+        futuro: string;
+        minutos: string;
+        horas: string;
+        dias: Plural;
+        meses: Plural;
+        anos: Plural;
+        atrasado: string;
+        hoje: string;
+        amanhaRotulo: string;
+        venceu: string;
+        venceHoje: string;
+        vence: string;
+        concluido: string;
+        bomDia: string;
+        boaTarde: string;
+        boaNoite: string;
+    };
+    entidade: {
+        novo: string;
+        editar: string;
+        leitura: string;
+    };
+    abas: {
+        pendencias: Plural;
+    };
+    alerta: {
+        fechar: string;
+    };
+    anexo: {
+        minimo: Plural;
+        escolher: string;
+        anexo: string;
+        foto: string;
+        previaIndisponivel: string;
+        arquivoIndisponivel: string;
+        pdf: string;
+        imagem: string;
+        controlesImagem: string;
+        reduzir: string;
+        ampliar: string;
+        ajustar: string;
+        girar: string;
+        excede: Plural;
+        arrasteVarios: string;
+        arrasteUm: string;
+        ateTamanho: string;
+        visualizar: string;
+        removerNome: string;
+        contador: string;
+        fotoDe: string;
+        fotoN: string;
+        ampliarFoto: string;
+        ampliarFotoDe: string;
+        imagemDe: string;
+    };
+    avaliacao: {
+        salvando: string;
+        de: string;
+    };
+    avatares: {
+        rotulo: string;
+    };
+    codigo: {
+        copiar: string;
+        copiado: string;
+    };
+    busca: {
+        placeholder: string;
+        encontrados: Plural;
+        nada: string;
+        menu: string;
+        nenhumResultado: string;
+        excedente: Plural;
+    };
+    cidade: {
+        rotulo: string;
+        escolhaUf: string;
+    };
+    mensagem: {
+        placeholder: string;
+        rotulo: string;
+        enviar: string;
+        parar: string;
+        anexos: string;
+        tentarNovamente: string;
+        copiar: string;
+        copiada: string;
+        gerando: string;
+        enviando: string;
+        erro: string;
+        enviandoProgresso: string;
+        enviandoNome: string;
+        removerNome: string;
+    };
+    card: {
+        telaCheia: string;
+        sairTelaCheia: string;
+    };
+    carrossel: {
+        anterior: string;
+        proximo: string;
+        irPara: string;
+        pausar: string;
+        retomar: string;
+        posicao: string;
+    };
+    chat: {
+        titulo: string;
+        fechar: string;
+        novas: Plural;
+    };
+    citacao: {
+        em: string;
+    };
+    confirmacao: {
+        removerTitulo: string;
+        removerMensagem: string;
+        entendi: string;
+    };
+    conversa: {
+        rotulo: string;
+        irFim: string;
+        vazioTitulo: string;
+        vazioDescricao: string;
+        lista: string;
+        nova: string;
+        vazia: string;
+        fixadas: string;
+        ultimos7: string;
+        ultimos30: string;
+        buscar: string;
+        nadaEncontrado: string;
+        fixar: string;
+        desafixar: string;
+        novoNome: string;
+        sugestoesRotulo: string;
+    };
+    estrutura: {
+        buscarNoSistema: string;
+        inicio: string;
+        recolherMenu: string;
+        expandirMenu: string;
+        fecharSubmenu: string;
+        abrirMenu: string;
+        densidade: string;
+        densidadeAtual: string;
+        compacta: string;
+        confortavel: string;
+        espacosa: string;
+        desenvolvimento: string;
+        notificacoes: string;
+        naoLidas: Plural;
+        usuario: string;
+        menuUsuario: string;
+        contaPreferencias: string;
+        buscaGlobal: string;
+        aparencia: string;
+        pularConteudo: string;
+        ambienteSr: string;
+        versaoSr: string;
+        submenu: string;
+        naoLidasCurto: string;
+        semNotificacoesTudo: string;
+        contaDe: string;
+    };
+    filtros: {
+        consultar: string;
+        consultarAlterado: string;
+        limpar: string;
+        alterados: string;
+        aplicados: string;
+        removerChip: string;
+    };
+    form: {
+        formularios: string;
+        pronto: string;
+        pendencias: Plural;
+    };
+    grafico: {
+        categoria: string;
+        data: string;
+        valor: string;
+        semDados: string;
+        verGrafico: string;
+        verDados: string;
+        series: string;
+        esconderSerie: string;
+        mostrarSerie: string;
+        eixo: string;
+        eixoEsquerdo: string;
+        eixoDireito: string;
+        semDado: string;
+        pontos: string;
+        destaque: string;
+        tendencia: string;
+        ponto: string;
+        pontoN: string;
+        linha: string;
+        outros: string;
+        item: string;
+        participacao: string;
+        total: string;
+        totalDe: string;
+        fatias: string;
+        esconderFatia: string;
+        mostrarFatia: string;
+        alta: string;
+        queda: string;
+    };
+    kanban: {
+        prioridadeBaixa: string;
+        prioridadeMedia: string;
+        prioridadeAlta: string;
+        prioridadeCritica: string;
+        prioridade: string;
+        aberta: string;
+        andamento: string;
+        bloqueada: string;
+        concluida: string;
+        subtarefas: string;
+        subtarefasFeitas: string;
+        comentarios: Plural;
+        anexos: Plural;
+        vazioTitulo: string;
+        vazioDescricao: string;
+        quadro: string;
+        excluirColuna: string;
+        visiveis: string;
+        cartoes: Plural;
+        limite: string;
+        expandirColuna: string;
+        novoNomeColuna: string;
+        nomeColuna: string;
+        acoesColuna: string;
+        acoesColunaCurto: string;
+        tituloNovoCartao: string;
+        tituloCartao: string;
+        adicionarCartao: string;
+        noLimite: string;
+        nomeNovaColuna: string;
+        adicionarColuna: string;
+        emColuna: string;
+    };
+    listaTarefas: {
+        vazioTitulo: string;
+        rotulo: string;
+        concluida: string;
+        concluir: string;
+        reabrir: string;
+    };
+    menu: {
+        maisOpcoes: string;
+        maisOpcoesDe: string;
+    };
+    periodo: {
+        rotulo: string;
+        anterior: {
+            mes: string;
+            trimestre: string;
+            ano: string;
+            personalizado: string;
+        };
+        proximo: {
+            mes: string;
+            trimestre: string;
+            ano: string;
+            personalizado: string;
+        };
+        escolher: string;
+        esteMes: string;
+        mesPassado: string;
+        esteTrimestre: string;
+        esteAno: string;
+        anoPassado: string;
+        livre: string;
+        de: string;
+        ate: string;
+        antesDoInicio: string;
+        /** `rotuloPeriodo`: "novembro de 2026", "3º trimestre de 2026", "5 de nov. a 14 de nov. de 2026". */
+        mesAno: string;
+        trimestreN: string;
+        trimestreAno: string;
+        diaAno: string;
+        intervalo: string;
+    };
+    paginacao: {
+        rotulo: string;
+        anterior: string;
+        proxima: string;
+        /** `{faixa}` (ex.: 1–10) aparece em negrito. */
+        exibindo: string;
+        porPagina: string;
+    };
+    picklist: {
+        disponiveis: string;
+        selecionados: string;
+        movido: string;
+        movidos: string;
+        posicao: string;
+        nadaEncontrado: string;
+        nenhumItem: string;
+        moverSelecionados: string;
+        moverTodos: string;
+        devolverSelecionados: string;
+        devolverTodos: string;
+        reordenado: string;
+        buscarEm: string;
+    };
+    quadro: {
+        solto: string;
+        colunaSolta: string;
+        pego: string;
+        colunaPega: string;
+        cancelado: string;
+        colunaPosicao: string;
+        semDestino: string;
+        posicao: string;
+        arrastar: string;
+        moverColuna: string;
+        arrastarColuna: string;
+        mover: string;
+        colunaN: string;
+    };
+    referencias: {
+        mostrarTrecho: string;
+        mostrarMenos: string;
+        quantas: Plural;
+    };
+    contexto: {
+        trocar: string;
+        atual: string;
+    };
+    valor: {
+        ocultar: string;
+        mostrar: string;
+        oculto: string;
+    };
+    site: {
+        pesquisar: string;
+        paginaInicial: string;
+        abrirMenu: string;
+        redesSociais: string;
+        maisEscolhido: string;
+        newsletterTitulo: string;
+        newsletterCampo: string;
+        newsletterBotao: string;
+        newsletterOk: string;
+        newsletterInvalido: string;
+        newsletterErro: string;
+        nestaPagina: string;
+        nota: string;
+    };
+    tabela: {
+        rotulo: string;
+        selecionarTodos: string;
+        selecao: string;
+        selecionarLinha: string;
+        acoes: string;
+    };
+    login: {
+        titulo: string;
+        subtitulo: string;
+        codigoInstrucao: string;
+        erroEntrar: string;
+        informeDigitos: string;
+        erroCodigo: string;
+        sobre: string;
+        email: string;
+        emailPlaceholder: string;
+        usuario: string;
+        senha: string;
+        entrando: string;
+        entrar: string;
+        doisFatoresTitulo: string;
+        doisFatoresSubtitulo: string;
+        codigo: string;
+        confiar: string;
+        confiarDica: string;
+        cpf: string;
+    };
+    toast: {
+        fechar: string;
+    };
+    trilha: {
+        rotulo: string;
+    };
+    calendario: {
+        rotulo: string;
+        mes: string;
+        semana: string;
+        dia: string;
+        lista: string;
+        visao: string;
+        vazioMes: string;
+        semTitulo: string;
+        agoraTermina: string;
+        anterior: {
+            mes: string;
+            semana: string;
+            dia: string;
+        };
+        proximo: {
+            mes: string;
+            semana: string;
+            dia: string;
+        };
+        repete: string;
+        repeteSr: string;
+        repeteTitulo: string;
+        ate: string;
+        livre: string;
+        diaInteiro: string;
+        hoje: string;
+        eventos: Plural;
+        mais: string;
+        agora: string;
+        ajudaHorario: string;
+        ajudaTamanho: string;
+        ajudaEnter: string;
+        escolherDia: string;
+        comEventos: string;
+        /** Título da semana: "10 – 16 de novembro de 2026" ou "28 de out – 3 de nov de 2026". */
+        semanaMesmoMes: string;
+        semanaMeses: string;
+    };
+    boasVindas: {
+        ultimoAcesso: string;
+    };
+};
+/** Formato de todos os dicionários (o pt-BR é a fonte da verdade). */
+export type Textos = typeof textosPtBR;

package/dist/i18n/textos.d.ts

@@ -0,0 +1,17 @@
+import type { Idioma } from './idiomas.js';
+import { type Textos } from './pt-BR.js';
+/** Qualquer parte dos textos: cada componente e cada texto dele ficam opcionais. */
+export type TextosParciais = {
+    [K in keyof Textos]?: Textos[K] extends object ? {
+        [J in keyof Textos[K]]?: Textos[K][J];
+    } : Textos[K];
+};
+/** Os dicionários que vêm com a biblioteca. */
+export declare const DICIONARIOS: Record<'pt-BR' | 'en' | 'es', Textos>;
+/** Interno: o `ProvedorPreferencias` registra aqui os textos que o sistema passou. */
+export declare function registrarTextos(extras?: Partial<Record<Idioma, TextosParciais>>): void;
+/**
+ * O dicionário de um idioma: pt-BR por baixo (o que faltar sai em português),
+ * o dicionário pronto do idioma por cima e, por último, os textos do sistema.
+ */
+export declare function textosDe(idioma?: Idioma): Textos;