@thibezer/ui-components-kit 2.14.0 → 2.17.0

package/dist/card.cjs

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

package/dist/card.js

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

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

@@ -1,4 +1,11 @@
 import { SafeHTMLElement } from '../../core/ssr-safe';
+/**
+ * Avatar de usuário ou entidade com suporte a foto, iniciais automáticas, ícone padrão e status.
+ *
+ * @csspart base - O círculo/container do avatar.
+ * @csspart conteudo - Área interna da imagem ou iniciais.
+ * @csspart status - Indicador de presença.
+ */
 export declare class UIAvatar extends SafeHTMLElement {
     static get observedAttributes(): string[];
     private avatarElement;

package/dist/components/ui-barra-ferramentas/ui-paleta-ferramentas.d.ts

@@ -17,6 +17,8 @@ import { SafeHTMLElement } from '../../core/ssr-safe';
  *          ui-ferramenta { id, item, pai?, ativo?, origem } (cancelável: preventDefault reverte a ação)
  *
  * `valor` pode ser definido antes de `ferramentas`: fica pendente até a ferramenta existir.
+ *
+ * @csspart base - Contêiner raiz da paleta de ferramentas.
  */
 export declare class UIPaletaFerramentas extends SafeHTMLElement {
     static get observedAttributes(): string[];

package/dist/components/ui-canvas-cad/ui-canvas-cad.d.ts

@@ -13,6 +13,13 @@ import { OpcoesCamadaFeicoes, OpcoesLote, LoteFeicoes, ResultadoLote, ResultadoF
 import { EstiloFeicao, Feicao } from '../../gerencigeo-canvas/feature_types';
 import { SafeHTMLElement } from '../../core/ssr-safe';
 import { EstilosExternos } from './cad-estilos-externos';
+/**
+ * Viewport georreferenciada CAD/GIS com suporte a feições, snap, camadas e medição.
+ *
+ * @csspart base - Contêiner raiz interno do canvas CAD.
+ * @csspart viewport - Área onde o mapa e os renderizadores canvas/Leaflet são montados.
+ * @csspart camadas - Painel flutuante retrátil de gerenciamento de camadas.
+ */
 export declare class UICanvasCAD extends SafeHTMLElement {
     static get observedAttributes(): string[];
     private shadow;

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

@@ -9,6 +9,7 @@ import { SafeHTMLElement } from '../../core/ssr-safe';
  * @attr {string} camadas - Camadas base separadas por vírgula (`osm`, `satelite`, `topografia`, `ruas`).
  * @attr {string} aria-label - Nome acessível da região do mapa (padrão: "Mapa").
  * @fires ui-mapa-pronto - O mapa foi criado (`detail.map`); é emitido de novo se o elemento for reconectado.
+ * @csspart base - Contêiner interno do mapa Leaflet.
  */
 export declare class UIMapa extends SafeHTMLElement {
     static get observedAttributes(): string[];

package/dist/components/ui-seletor-mapa-base/ui-seletor-mapa-base.d.ts

@@ -1,6 +1,12 @@
 import { SafeHTMLElement } from '../../core/ssr-safe';
 import { MapaBaseItem, PosicaoSeletorMapaBase } from './tipos';
 export declare const MAPAS_BASE_PADRAO: MapaBaseItem[];
+/**
+ * Seletor discreto/flutuante para alternar mapas base.
+ *
+ * @csspart base - Botão gatilho que exibe o mapa base ativo.
+ * @csspart lista - Popover com as opções de mapas base disponíveis.
+ */
 export declare class UISeletorMapaBase extends SafeHTMLElement {
     static get observedAttributes(): string[];
     private shadow;

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

@@ -1,6 +1,15 @@
 import { SafeHTMLElement } from '../../core/ssr-safe';
 export type VarianteSkeleton = 'texto' | 'circular' | 'retangular' | 'card';
 export type AnimacaoSkeleton = 'shimmer' | 'pulso' | 'nenhum';
+/**
+ * Placeholder estrutural animado (Skeleton Loader) para estados de carregamento.
+ *
+ * @csspart base - Elemento ou contêiner principal do esqueleto.
+ * @csspart midia - Bloco de mídia na variante `card`.
+ * @csspart avatar - Bloco circular na variante `card`.
+ * @csspart titulo - Bloco de título na variante `card`.
+ * @csspart linha - Cada linha individual de texto.
+ */
 export declare class UISkeleton extends SafeHTMLElement {
     static get observedAttributes(): string[];
     private rootElement;

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

@@ -1,5 +1,17 @@
 import { SafeHTMLElement } from '../../core/ssr-safe';
 export type TendenciaStat = 'alta' | 'positivo' | 'baixa' | 'negativo' | 'neutro';
+/**
+ * Cartão de métrica / KPI com tendência e slot para gráfico ou ação.
+ *
+ * @csspart base - Contêiner principal do indicador.
+ * @csspart cabecalho - Linha de título e ícone.
+ * @csspart rotulo - Rótulo da métrica.
+ * @csspart conteudo - Bloco do valor e variação.
+ * @csspart valor - Valor em destaque.
+ * @csspart indicador - Selo de variação/tendência.
+ * @csspart rodape - Rodapé descritivo ou slot auxiliar.
+ * @csspart descricao - Texto auxiliar do rodapé.
+ */
 export declare class UIStat extends SafeHTMLElement {
     static get observedAttributes(): string[];
     private statElement;

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

@@ -1,4 +1,5 @@
 import { TabelaColuna } from './tipos';
+export type ModoRenderCorpo = 'completo' | 'rolagem';
 export interface ContextoCorpoTabela {
     tbodyElement: HTMLTableSectionElement | null;
     tableElement: HTMLTableElement | null;
@@ -15,6 +16,10 @@ export interface ContextoCorpoTabela {
     filtroAtivo?: boolean;
     textoVazio?: string;
     textoSemResultados?: string;
+    /** `completo` recria as linhas; `rolagem` preserva as que seguem na janela virtual. */
+    modo?: ModoRenderCorpo;
+    /** Posição do item em `dados` (4º argumento do `render`); sem ela vale a posição exibida. */
+    indiceOriginal?: (item: Record<string, any>) => number;
     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-foco.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Foco dentro das células da <ui-tabela>.
+ * Responsabilidade única: guardar qual controle de qual linha tinha o foco antes de recriar o corpo e
+ * devolvê-lo ao controle equivalente depois (a linha é achada pelo objeto, pelo `data-id` ou pela posição).
+ */
+/** Controle focado dentro de uma célula (não a própria linha). */
+export interface FocoCelula {
+    item: Record<string, any> | undefined;
+    dataId: string | null;
+    indiceLinha: number;
+    indiceColuna: number;
+    /** Posição do elemento entre os descendentes da célula (a mesma estrutura é recriada pelo `render`). */
+    ordinal: number;
+    selecaoInicio: number | null;
+    selecaoFim: number | null;
+    /** Valor que o usuário digitou/marcou e ainda não foi gravado nos dados (undefined = sem edição pendente). */
+    digitado?: string | boolean;
+    /** Valor com que o controle foi renderizado: serve para saber se os dados mudaram por baixo da edição. */
+    valorInicial?: string | boolean;
+}
+/** Quem renderizou cada linha: permite achar o item de uma `<tr>` depois que o corpo é reconstruído. */
+export declare const itemDaLinha: WeakMap<Element, Record<string, any>>;
+/** Guarda o valor inicial dos campos nativos da célula recém-renderizada. */
+export declare function registrarValoresRenderizados(celula: Element): void;
+/** Registra o controle focado dentro do corpo, ou `null` se o foco está fora das células. */
+export declare function capturarFocoCelula(tbody: HTMLTableSectionElement): FocoCelula | null;
+/** Devolve o foco ao controle equivalente após recriar o corpo. Sem equivalente, não faz nada. */
+export declare function restaurarFocoCelula(tbody: HTMLTableSectionElement, foco: FocoCelula | null): void;

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

@@ -4,6 +4,7 @@ export declare function normalizarTexto(t: string): string;
 export declare class TabelaOrquestradorDados {
     private dadosOriginais;
     private dadosExibicao;
+    private indicePorItem;
     private colunaOrdenada;
     private direcaoOrdenacao;
     private ultimoFiltro;
@@ -19,6 +20,8 @@ export declare class TabelaOrquestradorDados {
     setColunasFiltro(ids: string[]): void;
     getDadosOriginais(): Record<string, any>[];
     setDadosOriginais(dados: Record<string, any>[]): void;
+    /** Posição do item em `dados` (-1 se não pertence). Índice por objeto montado sob demanda, uma vez por troca de dados. */
+    indiceOriginal(item: Record<string, any>): number;
     getDadosExibicao(): Record<string, any>[];
     getColunaOrdenada(): string | null;
     setColunaOrdenada(id: string | null): void;

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

@@ -1,4 +1,5 @@
 import { TabelaColuna } from './tipos';
+import { ModoRenderCorpo } from './tabela-corpo';
 import { ListenerBag } from '../../core/listener-bag';
 import { EstruturaDOMElementos } from './tabela-dom';
 import { TabelaOrquestradorDados } from './tabela-orquestrador-dados';
@@ -20,6 +21,8 @@ export interface ContextoOrquestradorRender {
     virtualizar: boolean;
     rowHeight: number;
     indiceAtivo: number | null;
+    /** `rolagem` preserva as linhas que seguem visíveis na janela virtual (padrão: `completo`). */
+    modoCorpo?: ModoRenderCorpo;
     textoVazio?: string;
     textoSemResultados?: string;
     onSetIsResizing: (resizing: boolean) => void;

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

@@ -17,7 +17,13 @@ export interface TabelaColuna<T = any> {
     comparador?: (a: any, b: any, itemA: T, itemB: T) => number;
     /** Texto pesquisável da célula (o filtro padrão olha o valor bruto); útil quando `render` formata o valor. */
     textoFiltro?: (valor: any, item: T) => string;
-    render?: (valor: any, item: T, index: number) => HTMLElement | string;
+    /**
+     * Conteúdo da célula: `HTMLElement` (botão, checkbox, campo...) ou texto (nunca HTML).
+     * `index` é a posição **exibida** (muda ao ordenar e filtrar); `indiceDados` é a posição do item em `dados`
+     * (estável). Para editar ou remover, prefira `item` ou `indiceDados` a `index`.
+     * Na rolagem com virtualização, linhas que continuam visíveis não são renderizadas de novo.
+     */
+    render?: (valor: any, item: T, index: number, indiceDados: number) => HTMLElement | string;
 }
 export interface UISortDetail {
     idColuna: string | null;

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

@@ -1,4 +1,5 @@
 import { DensidadeTabela, TabelaColuna, TabelaFetcher, UISortDetail, UIColumnResizeDetail, UIRowScrollOptions, UISelecaoRemovidaDetail, UIFetchErroDetail } from './tipos';
+import { ModoRenderCorpo } from './tabela-corpo';
 import { SafeHTMLElement } from '../../core/ssr-safe';
 export type { DensidadeTabela, TabelaColuna, TabelaFetcher, UISortDetail, UIColumnResizeDetail, UIRowScrollOptions, UISelecaoRemovidaDetail, UIFetchErroDetail };
 export declare class UITabela extends SafeHTMLElement {
@@ -119,7 +120,11 @@ export declare class UITabela extends SafeHTMLElement {
     private handleTecladoCorpo;
     private obterContextoRenderizador;
     private renderHeader;
-    renderBody(): void;
+    /**
+     * Renderiza o corpo. `completo` (padrão) recria as linhas e roda o `render` das colunas de novo;
+     * `rolagem` só ajusta a janela virtual e mantém as linhas que continuam visíveis (foco e texto digitado intactos).
+     */
+    renderBody(modo?: ModoRenderCorpo): void;
     /**
      * Rola até um item e opcionalmente o seleciona. Aceita ID (pela `chave-id`, depois `id`, `_id`,
      * `codigo`, `key`), predicado ou índice. Um número é procurado primeiro como ID; use

package/dist/components/ui-tabela-propriedades/propriedades-dom-utils.d.ts

@@ -24,6 +24,7 @@ export declare function marcarSelectMisto(select: HTMLSelectElement, texto: stri
 export declare function focarProximoEditor(shadow: ShadowRoot, atual: HTMLElement): void;
 export declare function focarEditorAnterior(shadow: ShadowRoot, atual: HTMLElement): void;
 export declare function focarPrimeiroEditor(shadow: ShadowRoot): void;
+export declare function sincronizarDomCategorias(shadow: ShadowRoot, categorias: CategoriaPropriedades[], obterCategoriaAberta: (cat: CategoriaPropriedades) => boolean): void;
 export declare function expandirTodasCategorias(shadow: ShadowRoot, categorias: CategoriaPropriedades[]): void;
 export declare function colapsarTodasCategorias(shadow: ShadowRoot, categorias: CategoriaPropriedades[]): void;
-export declare function alternarCategoria(shadow: ShadowRoot, host: HTMLElement, categorias: CategoriaPropriedades[], idCategoria: string): void;
+export declare function alternarCategoria(shadow: ShadowRoot, host: HTMLElement, categorias: CategoriaPropriedades[], idCategoria: string, estadoAtualOverride?: boolean): boolean | undefined;

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

@@ -0,0 +1,63 @@
+import { CategoriaPropriedades, EstadoPersistidoPropriedades, UICategoriasEstadoDetail } from './tipos';
+export interface ContextoLembrancaPropriedades {
+    persistir: boolean;
+    conectado: boolean;
+    storageKey: string | null;
+    id: string;
+}
+/**
+ * Gera a chave determinística usada no localStorage para uma instância do painel.
+ */
+export declare function gerarChaveStoragePropriedades(storageKey?: string | null, elementId?: string | null): string;
+/**
+ * Valida e sanitiza o JSON vindo do storage campo a campo.
+ * Entradas inválidas ou com poluição de protótipo são descartadas sem lançar exceção.
+ */
+export declare function normalizarEstadoPersistidoPropriedades(bruto: unknown): EstadoPersistidoPropriedades | null;
+/**
+ * Lê o estado persistido do localStorage de forma segura em SSR e ambientes restritos.
+ */
+export declare function carregarEstadoPropriedades(storageKey: string): EstadoPersistidoPropriedades | null;
+/**
+ * Grava o estado persistido no localStorage com proteção contra cota excedida e restrições de sandbox.
+ */
+export declare function salvarEstadoPropriedades(storageKey: string, estado: EstadoPersistidoPropriedades): void;
+/**
+ * Remove o estado persistido no localStorage sem falhar em ambientes restritos.
+ */
+export declare function limparEstadoPropriedades(storageKey: string): void;
+/** Extrai o identificador normalizado de uma categoria ou devolve `null` se inválido. */
+export declare function idDaCategoria(cat: unknown): string | null;
+/** Estado padrão declarado pelo objeto `CategoriaPropriedades` (`true` quando omitido). */
+export declare function abertoPadraoDaCategoria(cat: CategoriaPropriedades): boolean;
+/** Atualiza `aberto` (e `aberta`, se existir) no objeto da categoria sem quebrar objetos congelados. */
+export declare function sincronizarCampoAberto(cat: CategoriaPropriedades, aberto: boolean): void;
+/**
+ * Gerencia o estado lembrado de abertura/fechamento das categorias em memória e no localStorage.
+ */
+export declare class LembrancaCategoriasPropriedades {
+    private readonly getContexto;
+    private preferencias;
+    private origensAberto;
+    private ultimaChaveCarregada;
+    constructor(getContexto: () => ContextoLembrancaPropriedades);
+    chaveAtual(): string;
+    /** Carrega preferências do storage. Quando `substituirExistentes` é falso, preserva alterações feitas antes da conexão. */
+    carregarDoStorage(substituirExistentes?: boolean): boolean;
+    /** Recarrega o estado se `id` ou `storage-key` tiver mudado após a conexão. */
+    sincronizarSeChaveMudou(): boolean;
+    /** Registra os padrões originais enviados pela aplicação para permitir restauração via `limpar()`. */
+    registrarOrigens(categorias: CategoriaPropriedades[]): void;
+    /** Aplica sobre os objetos mutáveis de `categorias` as preferências lembradas para cada `id`. */
+    aplicarEmCategorias(categorias: CategoriaPropriedades[]): void;
+    /** Restaura nos objetos mutáveis os valores iniciais enviados pela aplicação. */
+    restaurarOrigensEmCategorias(categorias: CategoriaPropriedades[]): void;
+    /** Estado efetivo da categoria considerando preferência lembrada e padrão da própria categoria. */
+    estaAberta(cat: CategoriaPropriedades): boolean;
+    registrar(idCategoria: string, aberto: boolean, persistirAgora?: boolean): void;
+    registrarVarias(entradas: Iterable<[string, boolean]>, persistirAgora?: boolean): void;
+    salvar(): void;
+    limpar(categoriasAtuais?: CategoriaPropriedades[]): void;
+    obterEstado(categoriasAtuais: CategoriaPropriedades[]): Record<string, boolean>;
+    montarDetalheEvento(categoriasAtuais: CategoriaPropriedades[]): UICategoriasEstadoDetail;
+}

package/dist/components/ui-tabela-propriedades/propriedades-render-arvore.d.ts

@@ -16,6 +16,7 @@ export interface OpcoesRenderArvore {
     categorias: CategoriaPropriedades[];
     termoBusca: string;
     onToggleCategoria: (idCategoria: string) => void;
+    obterCategoriaAberta?: (categoria: CategoriaPropriedades) => boolean;
     linhaCtx: ContextoLinhaPropriedade;
 }
 /**

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

@@ -71,3 +71,19 @@ export interface ContextoEditorPropriedade {
     /** Texto exibido para valores mistos (atributo `texto-misto`); padrão "Varia". */
     obterTextoMisto?: () => string;
 }
+export interface EstadoPersistidoPropriedades {
+    versao: number;
+    /** Mapa `categoriaId -> aberto` das preferências de expansão salvas. */
+    categorias: Record<string, boolean>;
+    ultimaAtualizacao?: number;
+}
+export interface UICategoriasEstadoDetail {
+    /** Mapa `categoriaId -> aberto` das categorias atuais e lembradas. */
+    estado: Record<string, boolean>;
+    abertas: string[];
+    fechadas: string[];
+}
+export interface DefinirEstadoCategoriasOpcoes {
+    persistir?: boolean;
+    emitirEvento?: boolean;
+}

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

@@ -1,4 +1,4 @@
-import { CategoriaPropriedades, SeletorTipoItem } from './tipos';
+import { CategoriaPropriedades, SeletorTipoItem, DefinirEstadoCategoriasOpcoes } from './tipos';
 import { SafeHTMLElement } from '../../core/ssr-safe';
 export * from './tipos';
 export { avaliarExpressaoMatematica } from './avaliador-expressao';
@@ -9,16 +9,20 @@ export * from './propriedades-render-arvore';
 export * from './propriedades-gerenciador-valores';
 export * from './propriedades-painel-controles';
 export * from './propriedades-dom-utils';
+export * from './propriedades-persistencia';
 export * from './propriedades-flutuante';
 export * from './propriedades-densidade';
 export * from './propriedades-valor-misto';
 export declare class UITabelaPropriedades extends SafeHTMLElement {
+    private static instanciasChavePadrao;
     static get observedAttributes(): string[];
     private shadow;
     private listeners;
     private splitterListeners;
     private controladorSplitter;
     private gerenciadorValores;
+    private _conectado;
+    private readonly lembranca;
     private _categorias;
     private _tipos;
     private _tipoSelecionadoId;
@@ -53,6 +57,18 @@ export declare class UITabelaPropriedades extends SafeHTMLElement {
     set larguraRotulo(pct: number);
     get fechavel(): boolean;
     set fechavel(val: boolean);
+    /**
+     * Habilita a persistência das abas/categorias abertas no `localStorage`.
+     * Ativo por padrão (`true`); defina `persistir="false"` para manter apenas em memória.
+     */
+    get persistir(): boolean;
+    set persistir(val: boolean);
+    /**
+     * Chave customizada de armazenamento no `localStorage` (`storage-key`).
+     * Quando omitida, usa o atributo `id` do componente ou `'default'`.
+     */
+    get storageKey(): string | null;
+    set storageKey(val: string | null);
     get categorias(): CategoriaPropriedades[];
     set categorias(novasCategorias: CategoriaPropriedades[]);
     /**
@@ -82,6 +98,26 @@ export declare class UITabelaPropriedades extends SafeHTMLElement {
     expandirTudo(): void;
     colapsarTudo(): void;
     toggleCategoria(idCategoria: string): void;
+    /**
+     * Retorna a chave completa de armazenamento utilizada por esta instância no `localStorage`.
+     */
+    obterChaveStorageAtual(): string;
+    /**
+     * Retorna um mapa `{ categoriaId: aberto }` refletindo as abas atualmente lembradas e visíveis.
+     */
+    obterEstadoCategorias(): Record<string, boolean>;
+    /**
+     * Define programaticamente o estado aberto/fechado de um conjunto de categorias.
+     */
+    definirEstadoCategorias(estado: Record<string, boolean>, opcoes?: DefinirEstadoCategoriasOpcoes): void;
+    /**
+     * Remove as preferências lembradas em memória e no `localStorage`, restaurando o padrão das categorias.
+     */
+    limparEstadoCategorias(): void;
+    /**
+     * Alias compatível com `<ui-camadas>` para limpar a memória persistida das categorias.
+     */
+    limparLembranca(): void;
     get densidade(): 'padrao' | 'compacta' | 'ultracompacta' | 'relaxada';
     set densidade(val: 'padrao' | 'compacta' | 'ultracompacta' | 'relaxada');
     alternarDensidade(): string;
@@ -93,6 +129,9 @@ export declare class UITabelaPropriedades extends SafeHTMLElement {
     alternarColapsoHorizontal(): boolean;
     private syncState;
     private toggleExpandirTodas;
+    private atualizarRegistroChavePadrao;
+    private atualizarVisaoCategorias;
+    private emitirEstadoCategorias;
     private renderSeletorTipos;
     private renderCategorias;
 }

package/dist/core/degrade.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Utilitários puros (Camada L1) para resolução e sanitização de degradês internos.
+ * Não depende de DOM no nível de módulo (100% SSR-safe).
+ */
+/** Atributos aceitos nos hosts de Web Components para ativar/customizar degradê interno. */
+export declare const ATRIBUTOS_DEGRADE: readonly ["degrade", "gradiente", "gradient"];
+/** Classes utilitárias contextuais aceitas para ativação de degradê. */
+export declare const CLASSES_DEGRADE: readonly ["degrade", "ui-degrade", "gradiente", "ui-gradiente"];
+/** Mapa de presets semânticos de degradê para tokens do sistema de design ($L_0$). */
+export declare const PRESETS_DEGRADE: Readonly<Record<string, string>>;
+/** Verifica se o nome de atributo pertence aos aliases de degradê. */
+export declare function ehAtributoDegrade(nome: string): boolean;
+/**
+ * Valida e normaliza uma expressão CSS de degradê contra XSS, CSS injection e sintaxe quebrada.
+ * Aceita gradientes CSS nativos (lineares, radiais, cônicos, repetidos e em camadas) ou `var(--token)`.
+ */
+export declare function gradienteSeguro(valor: string): string | null;
+export interface ResultadoDegrade {
+    /** Indica se o componente deve entrar no modo visual de degradê. */
+    ativo: boolean;
+    /** Token CSS ou gradiente explícito quando especificado; `null` para modo booleano padrão. */
+    explicito: string | null;
+}
+/**
+ * Resolve o valor bruto dos atributos `degrade` / `gradiente` / `gradient` em estado e valor CSS seguro.
+ */
+export declare function resolverDegrade(valor: string | null | undefined, presetPadrao?: string): ResultadoDegrade;
+/** Lê o primeiro atributo de degradê presente no host (`degrade`, `gradiente` ou `gradient`). */
+export declare function obterValorAtributoDegrade(host: Element): string | null;
+/**
+ * Sincroniza o estado interno de degradê entre atributos do host e o elemento-alvo no Shadow DOM.
+ * Retorna `true` quando algum modo de degradê (atributo ou classe utilitária no host) está ativo.
+ */
+export declare function aplicarDegradeNoElemento(host: Element, alvoInterno: HTMLElement | null, presetExplicitoPadrao?: string): boolean;

package/dist/core/index.d.ts

@@ -7,3 +7,4 @@ export * from './form-validacao';
 export * from './acessibilidade';
 export * from './altura-controle';
 export * from './svg-seguro';
+export * from './degrade';

package/dist/core.cjs

@@ -1 +1 @@
-"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;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./ui-bus-XqBLlTYQ.cjs"),t=require("./zero-js-triggers-CgM9IIQB.cjs"),u=require("./listener-bag-D5omxZ9h.cjs"),i=require("./leaflet-loader-94z5VsdY.cjs"),o=require("./ssr-safe-CiHD1adl.cjs"),l=require("./form-validacao-DIeyQVH5.cjs"),a=require("./acessibilidade-CSzX-DkG.cjs"),e=require("./altura-controle-ukMRPckR.cjs"),s=require("./svg-seguro-J2RM1Ssf.cjs"),r=require("./degrade-CIxvOTUv.cjs");typeof document<"u"&&t.initZeroJSTriggers();exports.UIBus=n.UIBus;exports.initZeroJSTriggers=t.initZeroJSTriggers;exports.ListenerBag=u.ListenerBag;exports.carregarLeaflet=i.carregarLeaflet;exports.obterLeafletSincrono=i.obterLeafletSincrono;exports.SafeHTMLElement=o.SafeHTMLElement;exports.definirCustomElement=o.definirCustomElement;exports.isBrowser=o.isBrowser;exports.aplicarValidadeInternals=l.aplicarValidadeInternals;exports.validarRestricoesCampoTexto=l.validarRestricoesCampoTexto;exports.cliqueVeioDeRotuloExterno=a.cliqueVeioDeRotuloExterno;exports.gerarIdUnico=a.gerarIdUnico;exports.obterRotuloExterno=a.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;exports.ATRIBUTOS_DEGRADE=r.ATRIBUTOS_DEGRADE;exports.CLASSES_DEGRADE=r.CLASSES_DEGRADE;exports.PRESETS_DEGRADE=r.PRESETS_DEGRADE;exports.aplicarDegradeNoElemento=r.aplicarDegradeNoElemento;exports.ehAtributoDegrade=r.ehAtributoDegrade;exports.gradienteSeguro=r.gradienteSeguro;exports.obterValorAtributoDegrade=r.obterValorAtributoDegrade;exports.resolverDegrade=r.resolverDegrade;

package/dist/core.js

@@ -1,34 +1,43 @@
 import { U as t } from "./ui-bus-CUd99VJi.js";
-import { i as r } from "./zero-js-triggers-CJT988bR.js";
+import { i as a } 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();
+import { S as E, d as f, i as p } from "./ssr-safe-5cWfJP-s.js";
+import { a as g, v as u } from "./form-validacao-BlQFxUVj.js";
+import { c as S, g as T, o as c } from "./acessibilidade-CUlSXc2X.js";
+import { T as R, V as L, a as C, b, l as O, n as V, c as _, r as h } from "./altura-controle-vxQiXG4q.js";
+import { h as I } from "./svg-seguro-ChVJ2L2z.js";
+import { A as B, C as N, P as z, a as G, e as H, g as M, o as P, r as q } from "./degrade-gDa5sW__.js";
+typeof document < "u" && a();
 export {
+  B as ATRIBUTOS_DEGRADE,
+  N as CLASSES_DEGRADE,
   i as ListenerBag,
-  p as SafeHTMLElement,
+  z as PRESETS_DEGRADE,
+  E as SafeHTMLElement,
   R as TAMANHOS_CONTROLE,
   t as UIBus,
-  S as VARIAVEL_ALTURA_CONTROLE,
-  O as alturaDoTamanho,
-  V as aplicarAlturaControle,
-  d as aplicarValidadeInternals,
+  L as VARIAVEL_ALTURA_CONTROLE,
+  C as alturaDoTamanho,
+  b as aplicarAlturaControle,
+  G as aplicarDegradeNoElemento,
+  g 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,
+  S as cliqueVeioDeRotuloExterno,
+  f as definirCustomElement,
+  H as ehAtributoDegrade,
+  T as gerarIdUnico,
+  M as gradienteSeguro,
+  I as higienizarSvg,
+  a as initZeroJSTriggers,
+  p as isBrowser,
+  O as lerEntradaAltura,
+  V as normalizarAltura,
+  _ as normalizarTamanhoControle,
   m as obterLeafletSincrono,
-  E as obterRotuloExterno,
-  U as resolverAlturaControle,
-  A as validarRestricoesCampoTexto
+  c as obterRotuloExterno,
+  P as obterValorAtributoDegrade,
+  h as resolverAlturaControle,
+  q as resolverDegrade,
+  u as validarRestricoesCampoTexto
 };

package/dist/cores.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});;/* empty css                 */const r=require("./ui-seletor-cor-DPKqf5wb.cjs"),e=require("./ui-controle-cores-CuDFS8Y8.cjs");exports.PALETA_CORES_PADRAO=r.PALETA_CORES_PADRAO;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.normalizarEspessura=r.normalizarEspessura;exports.normalizarOpacidade=r.normalizarOpacidade;exports.UIControleCores=e.UIControleCores;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});;/* empty css                 */const r=require("./ui-seletor-cor-DPKqf5wb.cjs"),e=require("./ui-controle-cores-Bq_XUrIQ.cjs");exports.PALETA_CORES_PADRAO=r.PALETA_CORES_PADRAO;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.normalizarEspessura=r.normalizarEspessura;exports.normalizarOpacidade=r.normalizarOpacidade;exports.UIControleCores=e.UIControleCores;

package/dist/cores.js

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