@thibezer/ui-components-kit 2.8.2 → 2.9.0

package/dist/components/ui-tabela/ui-tabela.d.ts

@@ -31,8 +31,7 @@ export declare class UITabela extends SafeHTMLElement {
     private _indiceAtivo;
     /** Altura real das linhas medida no DOM; null = usa a estimativa da densidade. */
     private _alturaLinhaMedida;
-    /** Cancela a correção pendente de uma rolagem suave anterior. */
-    private _cancelarCorrecaoRolagem;
+    private rolagem;
     private remotaController;
     private selecaoController;
     private dadosController;
@@ -118,23 +117,6 @@ export declare class UITabela extends SafeHTMLElement {
      * Enter/Espaço selecionam a linha (mesmo caminho do clique, emite `ui-linha-clique`).
      */
     private handleTecladoCorpo;
-    private linhasPorPagina;
-    /** Foca a linha, renderizando a janela virtual se necessário, e a mantém visível abaixo do cabeçalho fixo. */
-    private focarLinha;
-    /**
-     * Quanto o container precisa rolar para a linha ficar inteira na área útil: abaixo do cabeçalho
-     * fixo e acima da barra de rolagem horizontal. 0 = já visível. Linha maior que a área alinha pelo topo.
-     */
-    private deslocamentoAteLinha;
-    /** Rola só o container da tabela (nunca a página, ao contrário de `scrollIntoView`). */
-    private rolarContainer;
-    /**
-     * Posiciona a linha exibida `indice` na área visível.
-     * Fora da janela virtual, rola até a posição estimada, renderiza a janela e corrige pela posição
-     * real da linha. No modo suave a correção ocorre ao fim da animação (`scrollend`, com timeout de
-     * segurança para navegadores sem o evento ou quando não há rolagem a fazer).
-     */
-    private posicionarLinha;
     private obterContextoRenderizador;
     private renderHeader;
     renderBody(): void;

package/dist/components/ui-tooltip/tooltip-popover.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Adaptador da Popover API para o balão do <ui-tooltip>.
+ * Responsabilidade única: abrir/fechar o balão na camada superior (top layer) quando o navegador suporta
+ * `popover`, sem casts soltos e sem engolir erros inesperados.
+ */
+export declare function mostrarPopover(el: HTMLElement): void;
+export declare function ocultarPopover(el: HTMLElement): void;

package/dist/components/ui-tooltip/tooltip-posicionamento.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Posicionamento do balão do <ui-tooltip>.
+ * Responsabilidade única: normalizar o lado pedido e calcular `top`/`left` (em px, relativos à janela) do balão,
+ * mantendo-o dentro da tela. Funções puras, sem acesso ao DOM.
+ */
+export type PosicaoTooltip = 'topo' | 'baixo' | 'esquerda' | 'direita';
+export interface Retangulo {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+}
+export interface Viewport {
+    largura: number;
+    altura: number;
+}
+/** Distância entre o gatilho e o balão (seta + folga). */
+export declare const DESLOCAMENTO_PX = 8;
+/** Margem mínima até a borda da janela. */
+export declare const MARGEM_TELA_PX = 8;
+/** Aceita português e inglês, ignora caixa e espaços; qualquer outra coisa vira `topo`. */
+export declare function normalizarPosicao(bruto: string | null | undefined): PosicaoTooltip;
+/** Posição do balão em torno do gatilho, limitada à janela (balão maior que a janela fica na margem). */
+export declare function calcularPosicaoBalao(gatilho: Retangulo, balao: Pick<Retangulo, 'width' | 'height'>, posicao: PosicaoTooltip, viewport: Viewport): {
+    top: number;
+    left: number;
+};

package/dist/components/ui-tooltip/ui-tooltip.d.ts

@@ -1,10 +1,28 @@
 import { SafeHTMLElement } from '../../core/ssr-safe';
+/**
+ * Dica contextual (e popover) ao redor de um gatilho.
+ *
+ * @attr {string} texto - Texto do balão (alias `text`); também vira `aria-description` do gatilho.
+ * @attr {'topo'|'baixo'|'esquerda'|'direita'} posicao - Lado do balão (alias `position`, aceita top/bottom/left/right).
+ * @attr {'hover'|'clique'} gatilho - Como abre (alias `trigger`); em telas de toque o toque sempre alterna.
+ * @attr {boolean} aberto - Balão visível (alias `open`).
+ * @attr {boolean} disabled - Desativa o tooltip; fecha se estiver aberto.
+ * @slot - Elemento gatilho.
+ * @slot conteudo - Conteúdo rico do balão.
+ * @csspart balao - O balão.
+ * @csspart texto - O texto do balão.
+ * @csspart seta - A seta do balão.
+ */
 export declare class UITooltip extends SafeHTMLElement {
     static get observedAttributes(): string[];
     private containerElement;
     private bubbleElement;
-    private _posicionamentoAtivo;
+    /** Ouvintes do host: valem enquanto o elemento está conectado. */
+    private ouvintesHost;
+    /** Ouvintes globais (documento/janela): valem só enquanto o balão está aberto. */
+    private ouvintesAberto;
     private _timerOcultar;
+    private _quadro;
     /** Gatilho que recebeu `aria-description` deste tooltip (para remover depois). */
     private _gatilhoDescrito;
     constructor();
@@ -17,8 +35,12 @@ export declare class UITooltip extends SafeHTMLElement {
     set disabled(val: boolean);
     mostrar(): void;
     ocultar(): void;
+    private lerGatilho;
     private posicionarBubble;
+    private cancelarQuadro;
     private syncState;
+    private abrirBalao;
+    private fecharBalao;
     private handleMouseEnter;
     private handleMouseLeave;
     private cancelarOcultar;
@@ -33,6 +55,7 @@ export declare class UITooltip extends SafeHTMLElement {
      */
     private sincronizarDescricao;
     private removerDescricao;
+    /** O clique do gatilho continua chegando aos ancestrais: o "clicar fora" já ignora cliques dentro do host. */
     private handleClick;
     private handleClickOutside;
 }

package/dist/core/altura-controle.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Altura única dos controles (botão, campo, lista, segmented, ui-linha).
+ * Responsabilidade única: transformar os atributos `altura` / `tamanho` / `densidade` (hostis por definição)
+ * no valor da variável CSS `--ui-campo-altura`, o contrato que todos os controles de uma mesma linha leem.
+ *
+ * Precedência: `altura` explícita > `tamanho`/`size`/`densidade` > herdado do contêiner (`ui-linha`, CSS do consumidor)
+ * > token global (`--ui-altura-md`).
+ */
+export declare const TAMANHOS_CONTROLE: readonly ["sm", "md", "lg"];
+export type TamanhoControle = (typeof TAMANHOS_CONTROLE)[number];
+/** Nome da variável CSS lida por todos os controles. */
+export declare const VARIAVEL_ALTURA_CONTROLE = "--ui-campo-altura";
+/** Reconhece `sm|md|lg` e os sinônimos de densidade (`compacta`, `padrao`, `relaxada`...). `null` se desconhecido. */
+export declare function normalizarTamanhoControle(valor: string | null | undefined): TamanhoControle | null;
+/** Valor CSS do tamanho nomeado, ou `null` quando o nome não é reconhecido. */
+export declare function alturaDoTamanho(valor: string | null | undefined): string | null;
+/**
+ * Altura explícita: número (px) ou número com unidade `px|rem|em`.
+ * Valores fora de [15px, 200px] são limitados; lixo (`NaN`, negativo, `calc(`, `;`) devolve `null`.
+ */
+export declare function normalizarAltura(valor: string | number | null | undefined): string | null;
+export interface EntradaAlturaControle {
+    altura?: string | null;
+    tamanho?: string | null;
+}
+/** Aplica a precedência `altura` > `tamanho`. `null` = nada a declarar (herda do contêiner/token). */
+export declare function resolverAlturaControle(entrada: EntradaAlturaControle): string | null;
+/** Lê os atributos (PT e EN) de um elemento no formato esperado por `resolverAlturaControle`. */
+export declare function lerEntradaAltura(el: Element): EntradaAlturaControle;
+/**
+ * Sincroniza `--ui-campo-altura` inline do elemento com seus atributos. Sem atributo válido, remove o que
+ * escrevemos (preservando uma variável inline do próprio consumidor) e o elemento herda do contêiner/token.
+ */
+export declare function aplicarAlturaControle(el: HTMLElement): void;

package/dist/core/index.d.ts

@@ -5,4 +5,5 @@ export * from './leaflet-loader';
 export * from './ssr-safe';
 export * from './form-validacao';
 export * from './acessibilidade';
+export * from './altura-controle';
 export * from './svg-seguro';

package/dist/core/opcoes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Escolha segura de opções vindas de atributos HTML.
+ * Responsabilidade única: transformar texto de atributo (hostil por definição) num valor de um conjunto
+ * conhecido, para que nunca vire nome de classe CSS arbitrário nem estado inesperado.
+ */
+/** Devolve `valor` (sem espaços, em minúsculas) se estiver em `permitidas`; senão `padrao`. */
+export declare function escolherOpcao<T extends string>(valor: string | null | undefined, permitidas: readonly T[], padrao: T): T;
+/** Como `escolherOpcao`, mas devolve `null` quando o valor não é reconhecido (opção opcional). */
+export declare function escolherOpcaoOpcional<T extends string>(valor: string | null | undefined, permitidas: readonly T[]): T | null;

package/dist/core/rotulo-controle.d.ts

@@ -0,0 +1,13 @@
+export interface OpcoesRotuloControle {
+    host: HTMLElement;
+    internals?: {
+        labels?: NodeList;
+    } | null;
+    /** Elemento interno com o papel (switch/checkbox/radio) que recebe o nome acessível. */
+    controle: HTMLElement;
+    /** Elemento interno que exibe o texto do rótulo; precisa ter `id`. */
+    rotulo: HTMLElement;
+    /** Valor do atributo `label` (texto puro, nunca HTML). */
+    texto: string | null;
+}
+export declare function sincronizarRotuloControle({ host, internals, controle, rotulo, texto }: OpcoesRotuloControle): void;

package/dist/core.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./ui-bus-XqBLlTYQ.cjs"),i=require("./zero-js-triggers-CgM9IIQB.cjs"),a=require("./listener-bag-D5omxZ9h.cjs"),o=require("./leaflet-loader-94z5VsdY.cjs"),r=require("./ssr-safe-CiHD1adl.cjs"),e=require("./form-validacao-ytRYSF3E.cjs"),n=require("./svg-seguro-J2RM1Ssf.cjs");typeof document<"u"&&i.initZeroJSTriggers();exports.UIBus=t.UIBus;exports.initZeroJSTriggers=i.initZeroJSTriggers;exports.ListenerBag=a.ListenerBag;exports.carregarLeaflet=o.carregarLeaflet;exports.obterLeafletSincrono=o.obterLeafletSincrono;exports.SafeHTMLElement=r.SafeHTMLElement;exports.definirCustomElement=r.definirCustomElement;exports.isBrowser=r.isBrowser;exports.aplicarValidadeInternals=e.aplicarValidadeInternals;exports.cliqueVeioDeRotuloExterno=e.cliqueVeioDeRotuloExterno;exports.gerarIdUnico=e.gerarIdUnico;exports.obterRotuloExterno=e.obterRotuloExterno;exports.validarRestricoesCampoTexto=e.validarRestricoesCampoTexto;exports.higienizarSvg=n.higienizarSvg;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./ui-bus-XqBLlTYQ.cjs"),a=require("./zero-js-triggers-CgM9IIQB.cjs"),l=require("./listener-bag-D5omxZ9h.cjs"),t=require("./leaflet-loader-94z5VsdY.cjs"),r=require("./ssr-safe-CiHD1adl.cjs"),i=require("./form-validacao-DIeyQVH5.cjs"),o=require("./acessibilidade-CSzX-DkG.cjs"),e=require("./altura-controle-ukMRPckR.cjs"),s=require("./svg-seguro-J2RM1Ssf.cjs");typeof document<"u"&&a.initZeroJSTriggers();exports.UIBus=n.UIBus;exports.initZeroJSTriggers=a.initZeroJSTriggers;exports.ListenerBag=l.ListenerBag;exports.carregarLeaflet=t.carregarLeaflet;exports.obterLeafletSincrono=t.obterLeafletSincrono;exports.SafeHTMLElement=r.SafeHTMLElement;exports.definirCustomElement=r.definirCustomElement;exports.isBrowser=r.isBrowser;exports.aplicarValidadeInternals=i.aplicarValidadeInternals;exports.validarRestricoesCampoTexto=i.validarRestricoesCampoTexto;exports.cliqueVeioDeRotuloExterno=o.cliqueVeioDeRotuloExterno;exports.gerarIdUnico=o.gerarIdUnico;exports.obterRotuloExterno=o.obterRotuloExterno;exports.TAMANHOS_CONTROLE=e.TAMANHOS_CONTROLE;exports.VARIAVEL_ALTURA_CONTROLE=e.VARIAVEL_ALTURA_CONTROLE;exports.alturaDoTamanho=e.alturaDoTamanho;exports.aplicarAlturaControle=e.aplicarAlturaControle;exports.lerEntradaAltura=e.lerEntradaAltura;exports.normalizarAltura=e.normalizarAltura;exports.normalizarTamanhoControle=e.normalizarTamanhoControle;exports.resolverAlturaControle=e.resolverAlturaControle;exports.higienizarSvg=s.higienizarSvg;

package/dist/core.js

@@ -1,24 +1,34 @@
 import { U as t } from "./ui-bus-CUd99VJi.js";
-import { i as e } from "./zero-js-triggers-CJT988bR.js";
-import { L as s } from "./listener-bag-DQgv7OON.js";
-import { c as f, o as m } from "./leaflet-loader-Cjcdgj5R.js";
-import { S as p, d as x, i as c } from "./ssr-safe-5cWfJP-s.js";
-import { a as g, c as u, g as L, o as S, v as E } from "./form-validacao-BIOXxt-1.js";
-import { h as B } from "./svg-seguro-ChVJ2L2z.js";
-typeof document < "u" && e();
+import { i as r } from "./zero-js-triggers-CJT988bR.js";
+import { L as i } from "./listener-bag-DQgv7OON.js";
+import { c as n, o as m } from "./leaflet-loader-Cjcdgj5R.js";
+import { S as p, d as u, i as x } from "./ssr-safe-5cWfJP-s.js";
+import { a as d, v as A } from "./form-validacao-BlQFxUVj.js";
+import { c as L, g, o as E } from "./acessibilidade-CUlSXc2X.js";
+import { T as R, V as S, a as O, b as V, l as h, n as v, c as I, r as U } from "./altura-controle-vxQiXG4q.js";
+import { h as z } from "./svg-seguro-ChVJ2L2z.js";
+typeof document < "u" && r();
 export {
-  s as ListenerBag,
+  i as ListenerBag,
   p as SafeHTMLElement,
+  R as TAMANHOS_CONTROLE,
   t as UIBus,
-  g as aplicarValidadeInternals,
-  f as carregarLeaflet,
-  u as cliqueVeioDeRotuloExterno,
-  x as definirCustomElement,
-  L as gerarIdUnico,
-  B as higienizarSvg,
-  e as initZeroJSTriggers,
-  c as isBrowser,
+  S as VARIAVEL_ALTURA_CONTROLE,
+  O as alturaDoTamanho,
+  V as aplicarAlturaControle,
+  d as aplicarValidadeInternals,
+  n as carregarLeaflet,
+  L as cliqueVeioDeRotuloExterno,
+  u as definirCustomElement,
+  g as gerarIdUnico,
+  z as higienizarSvg,
+  r as initZeroJSTriggers,
+  x as isBrowser,
+  h as lerEntradaAltura,
+  v as normalizarAltura,
+  I as normalizarTamanhoControle,
   m as obterLeafletSincrono,
-  S as obterRotuloExterno,
-  E as validarRestricoesCampoTexto
+  E as obterRotuloExterno,
+  U as resolverAlturaControle,
+  A as validarRestricoesCampoTexto
 };

package/dist/cores.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});;/* empty css                 */const r=require("./ui-controle-cores-Er6ZcQ7U.cjs");exports.PALETA_CORES_PADRAO=r.PALETA_CORES_PADRAO;exports.UIControleCores=r.UIControleCores;exports.UISeletorCor=r.UISeletorCor;exports.abrirSeletorCor=r.abrirSeletorCor;exports.coresUnicas=r.coresUnicas;exports.escaparHtml=r.escaparHtml;exports.fecharSeletorCor=r.fecharSeletorCor;exports.normalizarCor=r.normalizarCor;exports.normalizarOpacidade=r.normalizarOpacidade;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});;/* empty css                 */const r=require("./ui-controle-cores-uY__TgwW.cjs");exports.PALETA_CORES_PADRAO=r.PALETA_CORES_PADRAO;exports.UIControleCores=r.UIControleCores;exports.UISeletorCor=r.UISeletorCor;exports.abrirSeletorCor=r.abrirSeletorCor;exports.coresUnicas=r.coresUnicas;exports.escaparHtml=r.escaparHtml;exports.fecharSeletorCor=r.fecharSeletorCor;exports.normalizarCor=r.normalizarCor;exports.normalizarOpacidade=r.normalizarOpacidade;

package/dist/cores.js

@@ -1,5 +1,5 @@
 /* empty css               */
-import { P as e, U as s, a as l, b as t, c as C, e as c, f as i, n as m, d as n } from "./ui-controle-cores-BS0WYPdi.js";
+import { P as e, U as s, a as l, b as t, c as C, e as c, f as i, n as m, d as n } from "./ui-controle-cores-DgEza3wF.js";
 export {
   e as PALETA_CORES_PADRAO,
   s as UIControleCores,