@celke/kole-react 0.0.0-stage → 0.2.0

package/dist/utils/senha.d.ts

@@ -0,0 +1,21 @@
+/** Política de senha: o app declara só o que muda sobre `POLITICA_PADRAO`. */
+export interface PoliticaSenha {
+    minimo: number;
+    exigirMinuscula?: boolean;
+    exigirMaiuscula?: boolean;
+    exigirDigito?: boolean;
+    exigirSimbolo?: boolean;
+}
+export type NivelForcaSenha = 'vazia' | 'fraca' | 'media' | 'forte';
+export interface ForcaSenha {
+    /** 0 (vazia) a 4. Abaixo do mínimo fica preso em 1. */
+    score: number;
+    nivel: NivelForcaSenha;
+}
+/** Padrão da biblioteca: só o tamanho. */
+export declare const POLITICA_PADRAO: PoliticaSenha;
+/** Primeira regra violada (tamanho → minúscula → maiúscula → dígito → símbolo), ou `''`. */
+export declare function validarSenha(senha: string, politica?: PoliticaSenha): string;
+/** Heurística barata: +1 por classe de caractere, +1 com `minimo + 4` de tamanho. */
+export declare function forcaSenha(senha: string, politica?: PoliticaSenha): ForcaSenha;
+export declare function senhasIguais(a: string, b: string): boolean;

package/dist/utils/severidade.d.ts

@@ -0,0 +1,7 @@
+/** Fonte única de severidades; cada componente usa um recorte dela. */
+export declare const SEVERIDADES: readonly ["pri", "ok", "warn", "err", "info", "neutral"];
+export type SeveridadeCompleta = (typeof SEVERIDADES)[number];
+/** Cor SÓLIDA da severidade (`var(--token)`) — para filete, tile ou marcador fora de um selo. */
+export declare function severidadeCor(sev: SeveridadeCompleta): string;
+/** O texto é um dos nomes de severidade? */
+export declare function ehSeveridade(valor: string): valor is SeveridadeCompleta;

package/dist/utils/texto.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Texto e número: listas e valores por extenso (documentos), leitura de
+ * caminho, formatação, saudação, iniciais, normalização para busca.
+ */
+/** `['A']` → `A` · `['A','B']` → `A e B` · `['A','B','C']` → `A, B e C`. */
+export declare function listaPorExtenso(itens: readonly string[]): string;
+/** Inteiro por extenso (trunca decimais): `1500` → `mil e quinhentos`. */
+export declare function numeroPorExtenso(num: number): string;
+/** Valor em reais por extenso: `1500.5` → `mil e quinhentos reais e cinquenta centavos`. */
+export declare function valorMonetarioPorExtenso(valor: number): string;
+/** Lê um caminho com ponto (`a.b.c`); `undefined` se algum trecho faltar. */
+export declare function lerCampo(obj: unknown, caminho: string): unknown;
+/** `1243` → `1.243` · compacto: `12400` → `12,4 mil` (deixe o valor cheio no `title`). */
+export declare function formatarNumero(valor: number, opcoes?: {
+    compacto?: boolean;
+}): string;
+/** 5–11h Bom dia · 12–17h Boa tarde · demais Boa noite. */
+export declare function saudacaoPorHora(agora?: Date): string;
+/** Primeira letra das duas primeiras palavras: `Gabrielly Ribeiro da Silva` → `GR`. */
+export declare function iniciais(nome: string): string;
+/** Sem acento e em minúsculas — a comparação de toda busca/filtro. */
+export declare function normalizar(s: string): string;
+/** Formata CPF (até 11 dígitos) ou CNPJ (12 a 14) enquanto digita. */
+export declare function formatCpfCnpj(v: string): string;
+/** Nome em caixa de título (pt-BR): `GABRIELLY RIBEIRO` → `Gabrielly Ribeiro`. */
+export declare function nomeProprio(valor: string): string;
+/** Primeiro + último nome: `GABRIELLY RIBEIRO DA SILVA` → `Gabrielly Silva`. */
+export declare function nomeCurto(valor: string): string;

package/dist/utils/tipos.d.ts

@@ -0,0 +1,8 @@
+/** Severidade de situação (selo, alerta, toast). */
+export type Severidade = 'ok' | 'info' | 'warn' | 'err' | 'neutral';
+/** Opção de select/escolha. */
+export interface Opcao<V = string> {
+    valor: V;
+    rotulo: string;
+    desabilitada?: boolean;
+}

package/dist/utils/tiposCampo.d.ts

@@ -0,0 +1,12 @@
+import { type Mascara } from './mascara.js';
+import { type TipoDeCampo } from './validadores.js';
+/** Descritor de um tipo de campo: máscara, placeholder, validação e caixa alta. */
+export interface MetaTipoCampo {
+    mascara?: Mascara;
+    placeholder?: string;
+    validar: (valor: string) => string;
+    /** `true` = sempre maiúscula (placa) · `false` = nunca (e-mail). */
+    caixaAlta?: boolean;
+}
+/** Fonte única de máscara/placeholder/validação de cada tipo de campo. */
+export declare const TIPOS_CAMPO: Record<TipoDeCampo, MetaTipoCampo>;

package/dist/utils/useBuscaAssincrona.d.ts

@@ -0,0 +1,22 @@
+/** Espera padrão entre a última tecla e a busca (ms). */
+export declare const BUSCA_ATRASO_MS = 300;
+export interface OpcoesBuscaAssincrona<T> {
+    /** A busca é do módulo: termo → registros. */
+    buscar: (termo: string) => Promise<T[]>;
+    /** Só busca enquanto `true` (ex.: painel aberto). Ao ligar, busca na hora, sem espera. */
+    ativo?: boolean;
+    /** Mínimo de caracteres; abaixo dele limpa sem chamar a API. */
+    minimo?: number;
+    atraso?: number;
+}
+/**
+ * Busca remota com espera de digitação e descarte de resposta velha: só a
+ * requisição MAIS RECENTE escreve o resultado ("ab" que volta depois de
+ * "abc" é ignorada). Erro da API vira lista vazia.
+ */
+export declare function useBuscaAssincrona<T>({ buscar, ativo, minimo, atraso }: OpcoesBuscaAssincrona<T>): {
+    termo: string;
+    setTermo: import("react").Dispatch<import("react").SetStateAction<string>>;
+    resultados: T[];
+    carregando: boolean;
+};

package/dist/utils/useCliqueFora.d.ts

@@ -0,0 +1,3 @@
+import { type RefObject } from 'react';
+/** Chama `aoClicarFora` em pointerdown fora de TODOS os elementos dados. */
+export declare function useCliqueFora(refs: Array<RefObject<HTMLElement | null>>, ativo: boolean, aoClicarFora: () => void): void;

package/dist/utils/usePosicaoFlutuante.d.ts

@@ -0,0 +1,13 @@
+import { type RefObject } from 'react';
+export interface PosicaoFlutuante {
+    top: number;
+    left: number;
+    width: number;
+    /** true quando abriu para CIMA por falta de espaço embaixo */
+    acima: boolean;
+}
+/**
+ * Posição `fixed` de um painel flutuante ancorado num elemento (select,
+ * dica). Recalcula em scroll (de qualquer container) e resize.
+ */
+export declare function usePosicaoFlutuante(ancora: RefObject<HTMLElement | null>, aberto: boolean, alturaEstimada?: number, espaco?: number): PosicaoFlutuante | null;

package/dist/utils/validadores.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Validadores de dados brasileiros: predicados `is*` + o despachante `validar()`.
+ * Lógica pura, sem React. A máscara de cada tipo mora em `tiposCampo.ts`.
+ */
+export declare const TIPOS_DE_CAMPO: readonly ["cpf", "cnpj", "cpfCnpj", "email", "cep", "telefone", "placa", "renavam", "chassi", "cnh", "imei", "hora", "data", "dataHora"];
+export type TipoDeCampo = (typeof TIPOS_DE_CAMPO)[number];
+/** CPF com os dois dígitos verificadores; rejeita sequências repetidas. */
+export declare function isCpf(v: string): boolean;
+/** CNPJ com os dois dígitos verificadores; rejeita sequências repetidas. */
+export declare function isCnpj(v: string): boolean;
+/** Mais de 11 dígitos = CNPJ; senão, CPF. */
+export declare function isCpfCnpj(v: string): boolean;
+export declare function isEmail(v: string): boolean;
+export declare function isCep(v: string): boolean;
+/** Fixo (10 dígitos) ou celular (11), sempre com DDD. */
+export declare function isTelefone(v: string): boolean;
+/** Placa antiga `AAA0000` ou Mercosul `AAA0A00` (aceita hífen). */
+export declare function isPlaca(v: string): boolean;
+/** RENAVAM: por enquanto só o tamanho (9 a 11 dígitos); o dígito verificador fica para depois. */
+export declare function isRenavam(v: string): boolean;
+/** Chassi (VIN): 17 caracteres alfanuméricos, sem I, O e Q. */
+export declare function isChassi(v: string): boolean;
+/** CNH: 9 dígitos + 2 verificadores (algoritmo do DENATRAN). */
+export declare function isCnh(v: string): boolean;
+/** IMEI: 15 dígitos validados por Luhn; rejeita sequências repetidas. */
+export declare function isImei(v: string): boolean;
+/** `HH:mm` entre 00:00 e 23:59. */
+export declare function isHora(v: string): boolean;
+/** `dd/mm/aaaa` existente no calendário (31/02 é recusado). */
+export declare function isData(v: string): boolean;
+/** `dd/mm/aaaa HH:mm`. */
+export declare function isDataHora(v: string): boolean;
+/**
+ * Telefone, opcionalmente restrito a um formato. Vazio é válido
+ * (obrigatoriedade é assunto do campo, não do validador).
+ */
+export declare function validarTelefone(v: string, tipo?: 'fixo' | 'celular'): string;
+/**
+ * Mensagem de validação do tipo, ou `''` quando vazio ou válido.
+ * Separa "incompleto" (ainda digitando) de "inválido" (errado).
+ */
+export declare function validar(tipo: TipoDeCampo, valor: string): string;

package/package.json

@@ -1,6 +1,91 @@
-{
-  "name": "@celke/kole-react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "@celke/kole-react",
+  "version": "0.2.0",
+  "description": "Biblioteca de componentes React para sistemas administrativos.",
+  "license": "MIT",
+  "author": "Cesar Szpak",
+  "homepage": "https://github.com/celkecursos/kole-react#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/celkecursos/kole-react.git"
+  },
+  "bugs": {
+    "url": "https://github.com/celkecursos/kole-react/issues"
+  },
+  "keywords": [
+    "react",
+    "ui",
+    "componentes",
+    "design-system",
+    "layout",
+    "admin",
+    "dashboard",
+    "formulario",
+    "tabela",
+    "pt-br",
+    "celke"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./estilos.css": {
+      "types": "./dist/css.d.ts",
+      "default": "./dist/estilos.css"
+    },
+    "./tokens.css": {
+      "types": "./dist/css.d.ts",
+      "default": "./dist/tokens.css"
+    },
+    "./tailwind.css": {
+      "types": "./dist/css.d.ts",
+      "style": "./dist/tailwind.css",
+      "default": "./dist/tailwind.css"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && tsc -p tsconfig.build.json && node scripts/ajustar-tipos.mjs && node scripts/embutir-fonte.mjs",
+    "build:demo": "vite build --mode demo",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "visual": "playwright test",
+    "visual:referencia": "playwright test --update-snapshots --project=claro --project=escuro",
+    "prepare": "npm run build"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0 || ^19.0.0",
+    "react-dom": "^18.2.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@fontsource-variable/inter": "^5.2.8",
+    "@playwright/test": "^1.64.1",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "@vitejs/plugin-react": "^6.0.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "typescript": "~6.0.3",
+    "vite": "^8.0.0"
+  },
+  "dependencies": {
+    "lucide-react": "^1.60.0"
+  }
+}