@thibezer/ui-components-kit 1.0.0 → 2.0.0

package/dist/card.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});;/* empty css                 */const e=require("./ui-card-Bhm6k91e.cjs");exports.UICard=e.UICard;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});;/* empty css                 */const e=require("./ui-card-B86lJXTP.cjs");exports.UICard=e.UICard;

package/dist/card.js

@@ -1,5 +1,5 @@
 /* empty css               */
-import { U as m } from "./ui-card-BJ8SmvVf.js";
+import { U as m } from "./ui-card-C_o5_0cB.js";
 export {
   m as UICard
 };

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

@@ -1,16 +1,26 @@
 import { SafeHTMLElement } from '../../core/ssr-safe';
 export type VarianteBotao = 'primary' | 'primario' | 'secondary' | 'secundario' | 'ghost' | 'terciario' | 'destructive' | 'destrutivo' | 'erro' | 'icon-only' | 'icone' | 'destaque' | 'outline' | 'borda';
 export declare class UIBotao extends SafeHTMLElement {
+    /** Form-associated: respeita `form="id"` e `<fieldset disabled>` como um <button> nativo. */
+    static formAssociated: boolean;
     static get observedAttributes(): string[];
     private button;
     private spinnerContainer;
     private slotElement;
     private opticalState;
     private listeners;
+    private internals;
+    private _formDisabled;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(_name: string, _old: string | null, _value: string | null): void;
+    formDisabledCallback(disabled: boolean): void;
+    get form(): HTMLFormElement | null;
+    get disabled(): boolean;
+    set disabled(val: boolean);
+    /** Ativa o botão como um clique real (no-op se desabilitado ou carregando), como `HTMLButtonElement.click()`. */
+    click(): void;
     get carregando(): boolean;
     set carregando(val: boolean);
     private handleSlotChange;
@@ -20,6 +30,11 @@ export declare class UIBotao extends SafeHTMLElement {
      */
     private sanitizeAndBalanceContent;
     private syncState;
+    /**
+     * O foco e o anúncio do leitor de tela ficam no <button> interno, então os atributos
+     * ARIA do host são copiados para ele. Botão só com ícone e sem `aria-label` usa o `title`.
+     */
+    private sincronizarAria;
     private handleClick;
 }
 export declare class UIBotaoPrimario extends UIBotao {

package/dist/components/ui-campo-texto/ui-campo-texto.d.ts

@@ -47,6 +47,11 @@ export declare class UICampoTexto extends FormAssociatedElement {
     private handleRightIconKeyDown;
     private handleFocus;
     private handleBlur;
+    /**
+     * Enter submete o formulário como num <input> nativo. Aguarda um tick para que
+     * ouvintes do consumidor possam cancelar com `preventDefault()` no keydown.
+     */
+    private handleKeyDown;
     private handleInput;
     private handleChange;
 }

package/dist/components/ui-modal/modal-pilha.d.ts

@@ -0,0 +1,3 @@
+export declare function empilharModal(modal: HTMLElement): void;
+export declare function desempilharModal(modal: HTMLElement): void;
+export declare function ehModalDoTopo(modal: HTMLElement): boolean;

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

@@ -1,6 +1,5 @@
 import { SafeHTMLElement } from '../../core/ssr-safe';
 export declare class UIModal extends SafeHTMLElement {
-    static _openCount: number;
     static get observedAttributes(): string[];
     private backdropElement;
     private dialogElement;
@@ -9,21 +8,37 @@ export declare class UIModal extends SafeHTMLElement {
     private _elementoGatilho;
     private _focables;
     private _tituloId;
-    private _elementosInertes;
+    /** Estado já aplicado (pilha, inert, scroll, eventos); difere de `aberto` durante uma transição. */
+    private _estaAberto;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
-    attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+    attributeChangedCallback(_name: string, _old: string | null, _value: string | null): void;
     private handleSlotChange;
     get aberto(): boolean;
     set aberto(val: boolean);
     abrir(): void;
+    /** Fecha o modal, exceto com `bloquear-fechamento` (remova o atributo ou use `aberto = false` para forçar). */
     fechar(): void;
+    /**
+     * Abrir/fechar pelo método, pela propriedade ou pelo atributo (`aberto`/`open`, comum em
+     * React/Vue) passa sempre por aqui: mesmos eventos, mesmo foco e mesma camada de inert.
+     */
+    private aoAbrir;
+    private aoFechar;
+    /**
+     * Foco inicial: `[autofocus]`, senão o primeiro controle do conteúdo/rodapé.
+     * O botão "✕" não recebe o foco inicial, evitando fechar o modal com um Enter acidental;
+     * sem controles, o próprio diálogo é focado para que o leitor de tela anuncie o título.
+     */
+    private focarConteudoInicial;
     private syncState;
     private handleBackdropClick;
     private handleCloseClick;
+    private static ehFocavel;
+    /** Focáveis do conteúdo projetado (corpo e rodapé), na ordem dos slots. */
+    private obterFocaveisDoConteudo;
     private _atualizarFocables;
-    private _isTopMostModal;
     private handleKeyDown;
 }
 export declare class UIDialog extends UIModal {

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

@@ -9,6 +9,8 @@ export interface ContextoCorpoTabela {
     chaveId: string;
     virtualizar: boolean;
     rowHeight: number;
+    /** Linha que recebe tabindex=0 (foco móvel); fora da janela renderizada, vale a primeira visível. */
+    indiceAtivo?: number | null;
     isItemSelecionado: (item: Record<string, any>, index: number) => boolean;
     onLinhaClique: (item: Record<string, any>, index: number) => void;
     formatWidth: (largura?: string | number) => string;

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

@@ -19,6 +19,7 @@ export interface ContextoOrquestradorRender {
     chaveId: string;
     virtualizar: boolean;
     rowHeight: number;
+    indiceAtivo: number | null;
     onSetIsResizing: (resizing: boolean) => void;
     onActiveResizeCleanup: (cleanup: (() => void) | null) => void;
     onHeaderClick: (col: TabelaColuna) => void;

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

@@ -17,6 +17,11 @@ export declare class TabelaSelecaoController {
     setItemSelecionado(item: Record<string, any> | null): void;
     getIndiceSelecionado(): number | null;
     setIndiceSelecionado(idx: number | null): void;
+    /**
+     * Reaplica uma seleção anterior após ordenar, filtrar ou trocar os dados:
+     * mantém o item se ele (ou outro com a mesma chave) ainda estiver na exibição.
+     */
+    restaurarSelecao(item: Record<string, any>): void;
     limparSelecao(): void;
     isItemSelecionado(item: Record<string, any>, index: number): boolean;
     atualizarLinhasSelecionadas(): void;

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

@@ -20,6 +20,9 @@ export declare class UITabela extends SafeHTMLElement {
     private _scrollHandler;
     private _activeResizeCleanup;
     private _headerListeners;
+    private _corpoListeners;
+    /** Linha com o foco móvel (navegação por teclado); null = primeira linha visível. */
+    private _indiceAtivo;
     private remotaController;
     private selecaoController;
     private dadosController;
@@ -27,6 +30,8 @@ export declare class UITabela extends SafeHTMLElement {
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, _oldVal: string | null, newVal: string | null): void;
+    /** Nome acessível vem do host (`aria-label`); `aria-busy` acompanha o carregamento remoto. */
+    private sincronizarAria;
     private syncAttributes;
     private obterContextoAtributos;
     get src(): string | null;
@@ -64,6 +69,16 @@ export declare class UITabela extends SafeHTMLElement {
     private getRowHeight;
     private atualizarContextoSelecao;
     renderTotal(): void;
+    /** Mantém um único tabindex=0 (foco móvel): Tab entra na tabela pela última linha ativa. */
+    private handleFocoLinha;
+    /**
+     * Teclado nas linhas: setas, Home/End e PageUp/PageDown movem o foco;
+     * 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;
     private obterContextoRenderizador;
     private renderHeader;
     renderBody(): void;

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

@@ -4,6 +4,9 @@ export declare class UITooltip extends SafeHTMLElement {
     private containerElement;
     private bubbleElement;
     private _posicionamentoAtivo;
+    private _timerOcultar;
+    /** Gatilho que recebeu `aria-description` deste tooltip (para remover depois). */
+    private _gatilhoDescrito;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -18,6 +21,18 @@ export declare class UITooltip extends SafeHTMLElement {
     private syncState;
     private handleMouseEnter;
     private handleMouseLeave;
+    private cancelarOcultar;
+    /**
+     * Escape fecha o tooltip sem mover o foco (WCAG 1.4.13). Ouvido na captura e interrompido,
+     * para que dentro de um modal o primeiro Escape feche só o tooltip.
+     */
+    private handleEscape;
+    /**
+     * O balão vive no Shadow DOM, fora do alcance de `aria-describedby` do gatilho (light DOM).
+     * O texto é exposto como `aria-description` no gatilho, sem sobrescrever uma descrição do consumidor.
+     */
+    private sincronizarDescricao;
+    private removerDescricao;
     private handleClick;
     private handleClickOutside;
 }

package/dist/core/form-submissao.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Submissão de formulários a partir de controles encapsulados no Shadow DOM.
+ * O <button> e o <input> internos não pertencem ao <form> do consumidor, então
+ * o navegador não reconhece o botão como "submitter" nem o Enter no campo como
+ * submissão implícita. Estas funções reproduzem o comportamento nativo.
+ */
+/**
+ * Submete o formulário com validação nativa. Quando `nome` é informado, um <button>
+ * temporário leva o par nome/valor ao FormData, como faria um submitter nativo.
+ */
+export declare function submeterFormulario(form: HTMLFormElement, nome?: string | null, valor?: string | null): void;
+/**
+ * Submissão implícita (Enter em um campo de texto): aciona o botão padrão do formulário
+ * ou, sem botão, submete apenas se houver um único campo de texto.
+ */
+export declare function submeterImplicitamente(form: HTMLFormElement): void;

package/dist/core/parts.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Liga ou desliga um nome no atributo `part`, expondo estados ao CSS do consumidor
+ * (ex.: `ui-tabela::part(linha-selecionada)`). Usa o atributo em vez de `Element.part`
+ * para funcionar também em ambientes sem DOMTokenList de part (SSR, happy-dom).
+ */
+export declare function alternarPart(el: Element, nome: string, ativo: boolean): void;

package/dist/core/rotulo.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Escreve o texto do rótulo sempre como texto puro (nunca HTML), evitando que um
+ * `label` vindo de dados do servidor injete marcação. Quando obrigatório, acrescenta
+ * o asterisco decorativo, oculto de leitores de tela.
+ */
+export declare function renderizarRotulo(rotulo: HTMLElement, texto: string, obrigatorio: boolean, classeAsterisco: string): void;

package/dist/core/ui-bus.d.ts

@@ -28,6 +28,7 @@ export interface UIBusEventsMap {
 export type UIEmitterCallback<T = any> = (dados?: T) => void;
 declare class UIBusManager {
     private listeners;
+    constructor();
     /**
      * Registra um ouvinte para um canal ou evento global tipado.
      */
@@ -54,6 +55,7 @@ declare class UIBusManager {
     abrirModal(idModal: string): boolean;
     /**
      * Fecha um modal pelo seu ID ou todos os modais abertos se nenhum ID for passado.
+     * Retorna `false` se o modal não existir ou continuar aberto (`bloquear-fechamento`).
      */
     fecharModal(idModal?: string): boolean;
     /**
@@ -77,9 +79,18 @@ declare class UIBusManager {
      */
     definirDensidade(densidade: 'compacta' | 'normal' | 'padrao' | 'relaxada' | number): void;
     /**
-     * Alterna ou define o tema visual global.
+     * Tema em vigor: o forçado na raiz (`data-tema`, `data-theme`, `.dark`/`.light`)
+     * ou, sem nenhum, o do sistema operacional (`prefers-color-scheme`).
      */
-    definirTema(tema?: 'claro' | 'escuro'): string;
+    obterTema(): 'claro' | 'escuro';
+    /**
+     * Define o tema global. Sem argumento, alterna o tema em vigor;
+     * `'auto'` remove o tema forçado e volta a seguir o sistema operacional.
+     */
+    definirTema(tema?: 'claro' | 'escuro' | 'auto'): 'claro' | 'escuro';
+    /** Com o tema seguindo o SO, avisa `tema:alterado` quando o usuário troca o tema do sistema. */
+    private observarTemaDoSistema;
+    private _observandoSistema;
 }
 export declare const UIBus: UIBusManager;
 export {};

package/dist/core.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./zero-js-triggers-QGD7FOTv.cjs"),i=require("./listener-bag-D5omxZ9h.cjs"),t=require("./leaflet-loader-94z5VsdY.cjs"),o=require("./ssr-safe-CiHD1adl.cjs"),e=require("./form-validacao-ytRYSF3E.cjs");typeof document<"u"&&r.initZeroJSTriggers();exports.UIBus=r.UIBus;exports.initZeroJSTriggers=r.initZeroJSTriggers;exports.ListenerBag=i.ListenerBag;exports.carregarLeaflet=t.carregarLeaflet;exports.obterLeafletSincrono=t.obterLeafletSincrono;exports.SafeHTMLElement=o.SafeHTMLElement;exports.definirCustomElement=o.definirCustomElement;exports.isBrowser=o.isBrowser;exports.aplicarValidadeInternals=e.aplicarValidadeInternals;exports.cliqueVeioDeRotuloExterno=e.cliqueVeioDeRotuloExterno;exports.gerarIdUnico=e.gerarIdUnico;exports.obterRotuloExterno=e.obterRotuloExterno;exports.validarRestricoesCampoTexto=e.validarRestricoesCampoTexto;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./zero-js-triggers-C_gtaojZ.cjs"),i=require("./listener-bag-D5omxZ9h.cjs"),t=require("./leaflet-loader-94z5VsdY.cjs"),o=require("./ssr-safe-CiHD1adl.cjs"),e=require("./form-validacao-ytRYSF3E.cjs");typeof document<"u"&&r.initZeroJSTriggers();exports.UIBus=r.UIBus;exports.initZeroJSTriggers=r.initZeroJSTriggers;exports.ListenerBag=i.ListenerBag;exports.carregarLeaflet=t.carregarLeaflet;exports.obterLeafletSincrono=t.obterLeafletSincrono;exports.SafeHTMLElement=o.SafeHTMLElement;exports.definirCustomElement=o.definirCustomElement;exports.isBrowser=o.isBrowser;exports.aplicarValidadeInternals=e.aplicarValidadeInternals;exports.cliqueVeioDeRotuloExterno=e.cliqueVeioDeRotuloExterno;exports.gerarIdUnico=e.gerarIdUnico;exports.obterRotuloExterno=e.obterRotuloExterno;exports.validarRestricoesCampoTexto=e.validarRestricoesCampoTexto;

package/dist/core.js

@@ -1,5 +1,5 @@
-import { i as e } from "./zero-js-triggers-DdESy0tk.js";
-import { U as t } from "./zero-js-triggers-DdESy0tk.js";
+import { i as e } from "./zero-js-triggers-C_KrvFOQ.js";
+import { U as t } from "./zero-js-triggers-C_KrvFOQ.js";
 import { L as i } from "./listener-bag-DQgv7OON.js";
 import { c as f, o as m } from "./leaflet-loader-Cjcdgj5R.js";
 import { S as p, d as c, i as d } from "./ssr-safe-5cWfJP-s.js";