@thibezer/ui-components-kit 2.8.1 → 2.9.0

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

@@ -8,7 +8,12 @@ export declare function avisarIdsDuplicados(ids: string[], contexto: string): vo
 export declare function coletarIds(itens: FerramentaItem[], saida?: string[]): string[];
 export declare function aplicarEstadoBotao(btn: HTMLButtonElement, item: FerramentaItem): void;
 export declare function criarBotaoFerramenta(item: FerramentaItem, variante: VarianteBotaoFerramenta, tamanhoIcone: number): HTMLButtonElement;
+/** Cria um botão dividido (split button) com ação principal + seta dropdown separada. */
+export declare function criarBotaoDividido(item: FerramentaItem, variante: VarianteBotaoFerramenta, tamanhoIcone: number): HTMLElement;
 export declare function acharItem(itens: FerramentaItem[], id: string): FerramentaItem | undefined;
+/** O que `correspondeAtalho` lê de um evento de teclado (permite testar com objetos simples). */
+export type TeclaAtalho = Pick<KeyboardEvent, 'key' | 'ctrlKey' | 'metaKey' | 'altKey' | 'shiftKey'>;
+export declare function correspondeAtalho(e: TeclaAtalho, atalho: string | undefined): boolean;
 export declare function definirRoving(botoes: HTMLButtonElement[]): void;
 /** Garante um único botão com tabindex 0, preservando o atual se ainda estiver habilitado. */
 export declare function atualizarRoving(botoes: HTMLButtonElement[]): void;
@@ -16,8 +21,26 @@ export declare function atualizarRoving(botoes: HTMLButtonElement[]): void;
 export declare function seguirFoco(botoes: HTMLButtonElement[], alvo: EventTarget | null): void;
 /** Move o foco entre botões com as setas informadas. Retorna true se tratou a tecla. */
 export declare function navegarRoving(e: KeyboardEvent, botoes: HTMLButtonElement[], teclasAnterior: string[], teclasProximo: string[]): boolean;
+/** Navegação em grade de 2 colunas para paletas verticais com colunas=2. */
+export declare function navegarGrade2Colunas(e: KeyboardEvent, botoes: HTMLButtonElement[], rtl?: boolean): boolean;
+export declare class GerenciadorTooltip {
+    private raiz;
+    private el;
+    private textoEl;
+    private atalhoEl;
+    private timer;
+    private alvoAtual;
+    private readonly id;
+    private listeners;
+    constructor(raiz: ShadowRoot, container: HTMLElement);
+    private agendar;
+    mostrar(btn: HTMLElement, texto: string, atalho?: string): void;
+    esconder(): void;
+    private limparTimer;
+    destruir(): void;
+}
 export interface OpcoesMenu {
-    lado?: 'baixo' | 'direita';
+    lado?: 'baixo' | 'direita' | 'esquerda';
     /** Foca o primeiro item ao abrir (abertura por teclado). */
     focar?: boolean;
     /** Papel dos itens sem `tipo`: ribbon = botao (menuitem), paleta = ferramenta (menuitemradio). */

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

@@ -1,4 +1,10 @@
 import { FerramentaItem } from './tipos';
+import { TeclaAtalho } from './ferramentas-comum';
+/**
+ * Várias paletas com `atalhos` na mesma página: só a "dona" responde, a que contém o foco ou, sem foco em nenhuma, a
+ * primeira na ordem do DOM. `temFoco` diz se uma paleta contém o foco.
+ */
+export declare function paletaDonaDosAtalhos<T>(paletas: T[], temFoco: (p: T) => boolean): T | undefined;
 /**
  * `true` se o foco está num campo de digitação (nativo, editável ou customizado) ou dentro de um diálogo modal;
  * nesses lugares as letras pertencem ao usuário/ao diálogo.
@@ -10,7 +16,8 @@ export interface AtalhoResolvido {
     pai?: FerramentaItem;
 }
 /**
- * Ferramenta ativada pela `tecla` (uma letra, sem diferenciar caixa). Com várias candidatas, alterna entre elas
- * a partir da ativa. `todas` é a lista plana (grupos expandidos); `grupos` serve para achar o pai.
+ * Ferramenta ativada pela tecla. `tecla` é o evento de teclado (atalhos compostos: `Ctrl+Z`, `Shift+V`, `Esc`, via
+ * `correspondeAtalho`) ou só o `key` (uma tecla sem modificadores). Sem diferenciar caixa. Com várias candidatas,
+ * alterna entre elas a partir da ativa. `todas` é a lista plana (grupos expandidos); `grupos` serve para achar o pai.
  */
-export declare function resolverAtalho(tecla: string, todas: FerramentaItem[], grupos: FerramentaItem[], idAtivo: string): AtalhoResolvido | null;
+export declare function resolverAtalho(tecla: string | TeclaAtalho, todas: FerramentaItem[], grupos: FerramentaItem[], idAtivo: string): AtalhoResolvido | null;

package/dist/components/ui-barra-ferramentas/ribbon-render.d.ts

@@ -10,5 +10,13 @@ export interface OpcoesBotaoAba {
     idPainel: string;
 }
 export declare function criarBotaoAba({ aba, ativa, idBotao, idPainel }: OpcoesBotaoAba): HTMLButtonElement;
-export type CriarBotaoFerramenta = (item: FerramentaItem, variante: 'grande' | 'pequeno', tamanhoIcone: number) => HTMLButtonElement;
-export declare function criarGrupoRibbon(grupo: RibbonGrupo, criarBotao: CriarBotaoFerramenta): HTMLElement;
+export type CriarBotaoFerramenta = (item: FerramentaItem, variante: 'grande' | 'pequeno', tamanhoIcone: number) => HTMLElement;
+export interface OpcoesGrupoRibbon {
+    /** Sem espaço: o grupo vira um botão único com flyout (o clique é tratado por quem delega os cliques do painel). */
+    colapsado?: boolean;
+    /** Item `dividido` com `filhos`: ação principal + gatilho de menu (`criarBotaoDividido`). */
+    criarDividido?: CriarBotaoFerramenta;
+}
+/** Rótulo acessível do lançador de diálogo do grupo. */
+export declare const rotuloLancador: (grupo: RibbonGrupo) => string;
+export declare function criarGrupoRibbon(grupo: RibbonGrupo, criarBotao: CriarBotaoFerramenta, opcoes?: OpcoesGrupoRibbon): HTMLElement;

package/dist/components/ui-barra-ferramentas/ribbon-teclado.d.ts

@@ -1,11 +1,18 @@
 /**
- * Teclado das abas do <ui-ribbon> (padrão WAI-ARIA de abas com ativação automática).
+ * Teclado das abas do <ui-ribbon> (padrão WAI-ARIA de abas, com ativação automática ou manual).
  * Responsabilidade única: traduzir uma tecla em uma ação; quem chama executa (foco, seleção, painel).
  */
-export type AcaoTeclaAba = {
+export type AcaoTeclaAba = 
+/** Automática: foca e seleciona a aba. Manual (`ativacao-manual`): só move o foco. */
+{
     tipo: 'ir-para';
     indice: number;
 }
+/** Ativação manual: Enter/Espaço selecionam a aba focada. */
+ | {
+    tipo: 'ativar';
+    indice: number;
+}
 /** Seta para baixo: leva o foco aos botões do painel (abrindo o painel flutuante se recolhido). */
  | {
     tipo: 'descer';
@@ -14,4 +21,4 @@ export type AcaoTeclaAba = {
  * `indiceAtual` < 0 (foco fora das abas) ou lista vazia não produzem ação. Em RTL as setas se invertem.
  * Navegação circular; Home/End vão às pontas.
  */
-export declare function acaoDaTeclaAba(key: string, indiceAtual: number, total: number, rtl: boolean): AcaoTeclaAba | null;
+export declare function acaoDaTeclaAba(key: string, indiceAtual: number, total: number, rtl: boolean, manual?: boolean): AcaoTeclaAba | null;

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

@@ -32,11 +32,36 @@ export interface FerramentaItem {
     somenteIcone?: boolean;
     /** Ribbon: itens do menu suspenso. Paleta: ferramentas agrupadas (flyout). */
     filhos?: FerramentaItem[];
+    /**
+     * Ribbon: botão dividido (split button). A ação principal dispara no clique do corpo
+     * e a seta abre o menu suspenso com os `filhos`.
+     */
+    dividido?: boolean;
 }
 export interface RibbonGrupo {
     id: string;
     rotulo: string;
     itens: FerramentaItem[];
+    /**
+     * Prioridade para colapso automático quando a largura é insuficiente (estilo Office).
+     * Grupos de menor prioridade viram um botão único com flyout primeiro. Padrão: 0.
+     */
+    prioridade?: number;
+    /** Ícone exibido quando o grupo for colapsado em um botão de flyout. */
+    icone?: string;
+    /**
+     * Exibe um botão "lançador de diálogo" no canto inferior do grupo (estilo Office Dialog Box Launcher).
+     * Pode ser `true` ou o identificador/ação a disparar.
+     */
+    lancadorDialogo?: boolean | string;
+    /** Rótulo acessível para o botão lançador de diálogo. Padrão: "Mais opções de [rotulo]". */
+    rotuloLancador?: string;
+    /**
+     * Quando `true` (padrão para grupos com ferramentas no ribbon), garante exclusividade
+     * de seleção entre itens `tipo: 'ferramenta'` dentro do mesmo grupo.
+     * Defina como `false` para desativar a exclusividade automática no grupo.
+     */
+    exclusivo?: boolean;
 }
 export interface RibbonAba {
     id: string;
@@ -73,6 +98,11 @@ export interface PaletaChangeDetail {
 export interface RecolhidoChangeDetail {
     recolhido: boolean;
 }
+/** `detail` de `ui-grupo-dialogo` do ribbon (lançador de diálogo do grupo). */
+export interface GrupoDialogoDetail {
+    id: string;
+    grupo: RibbonGrupo;
+}
 declare global {
     interface HTMLElementEventMap {
         /** Cancelável: `preventDefault()` reverte o toggle / a seleção feita pelo clique. */
@@ -81,5 +111,6 @@ declare global {
         'ui-recolhido-change': CustomEvent<RecolhidoChangeDetail>;
         'ui-change': CustomEvent<PaletaChangeDetail>;
         'ui-selecionar': CustomEvent<PaletaChangeDetail>;
+        'ui-grupo-dialogo': CustomEvent<GrupoDialogoDetail>;
     }
 }

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

@@ -28,10 +28,20 @@ export declare class UIPaletaFerramentas extends SafeHTMLElement {
     private menu;
     private pressao;
     private listeners;
+    private tooltip;
+    private _modoControlado;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, old: string | null, value: string | null): void;
+    /**
+     * Quando `true` ou atributo `copiar-dados` / `modo-controlado`: clona a árvore de itens
+     * para não mutar os objetos fornecidos pelo consumidor (Item 11).
+     */
+    get modoControlado(): boolean;
+    set modoControlado(val: boolean);
+    get copiarDados(): boolean;
+    set copiarDados(val: boolean);
     get ferramentas(): FerramentaItem[];
     set ferramentas(val: FerramentaItem[]);
     get valor(): string;
@@ -72,6 +82,8 @@ export declare class UIPaletaFerramentas extends SafeHTMLElement {
     private handlePointerFim;
     private handleContextMenu;
     private handleKeyDown;
+    /** Várias paletas com `atalhos` na página: só a que contém o foco (ou a primeira no DOM) responde. */
+    private donaDosAtalhos;
     private handleAtalho;
     private abrirFlyout;
     private fecharMenu;

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

@@ -10,15 +10,26 @@ export declare class UIRibbon extends SafeHTMLElement {
     private readonly uid;
     private _abaPendente;
     private _pronto;
+    private _modoControlado;
     private _abas;
     private _abaAtiva;
     private menu;
     private listeners;
+    private tooltip;
+    private observerResize;
+    private gruposColapsados;
+    private keytipsAtivas;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, old: string | null, value: string | null): void;
     private aplicarRotulos;
+    get modoControlado(): boolean;
+    set modoControlado(val: boolean);
+    get copiarDados(): boolean;
+    set copiarDados(val: boolean);
+    get ativacaoManual(): boolean;
+    set ativacaoManual(val: boolean);
     get abas(): RibbonAba[];
     set abas(val: RibbonAba[]);
     get abaAtiva(): string;
@@ -40,6 +51,9 @@ export declare class UIRibbon extends SafeHTMLElement {
     private renderizarAbas;
     private idAba;
     private renderizarPainel;
+    private iniciarResizeObserver;
+    private ajustarColapsoGrupos;
+    private alternarMenuGrupoColapsado;
     private criarBotao;
     private botoesPainel;
     private handleClickAbas;
@@ -51,6 +65,8 @@ export declare class UIRibbon extends SafeHTMLElement {
     private handleKeyDownGrupos;
     private handleEscape;
     private handlePointerDownFora;
+    private handleAtalho;
+    private alternarKeyTips;
     private acionar;
     private alternarMenu;
     private fecharMenu;

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

@@ -3,6 +3,8 @@ import { Ponto, Segmento, BancoPonto, Confrontante, CanvasLayerState, CanvasGrap
 import { GerenciGeoMapaController } from '../../gerencigeo-canvas/mapa_controller';
 import { CanvasLayerManager } from '../../gerencigeo-canvas/layer_manager';
 import { ModoPopups } from '../../gerencigeo-canvas/popup_gate';
+import { ModoRenderizador } from '../../gerencigeo-canvas/renderers/feicoes_despachante';
+import { EstatisticasFeicoes } from '../../gerencigeo-canvas/renderers/renderizador_feicoes_tipos';
 import { UsuarioRemoto } from '../../gerencigeo-canvas/feature_cursores';
 import { EventoMapaCad, LatLngEvento } from './tipos';
 import { PontoPixel } from './cad-evento-coordenadas';
@@ -80,6 +82,19 @@ export declare class UICanvasCAD extends SafeHTMLElement {
      */
     get popups(): ModoPopups;
     set popups(val: ModoPopups);
+    /**
+     * Quem desenha as camadas de feições (atributo `renderizador`): `leaflet` (padrão; um objeto Leaflet por feição) ou
+     * `canvas` (motor sem DOM + Canvas 2D: um canvas por camada e um de sobreposição para seleção, formas minúsculas
+     * como marcas em lote, só um objeto Leaflet por marcador de ícone, texto, cluster e rótulo). Valor inválido usa
+     * `leaflet`. Ao mudar, as camadas de feições são recriadas; a API, os eventos e os dados não mudam.
+     */
+    get renderizador(): ModoRenderizador;
+    set renderizador(val: ModoRenderizador);
+    /**
+     * Contadores do desenho de uma camada de feições (`total`, `materializadas`, `desenhadas`, `marcasLOD`, `clusters`,
+     * `canvases`, `renderizador`...), para diagnóstico e benchmark. `null` se a camada não está desenhada.
+     */
+    estatisticasFeicoes(camadaId: string): EstatisticasFeicoes | null;
     get modoSequencial(): boolean;
     set modoSequencial(val: boolean);
     get chaveGrupo(): string | undefined;

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-C76iLlAZ.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"),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

@@ -6,7 +6,7 @@ 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-BsbNQqpd.js";
+import { h as z } from "./svg-seguro-ChVJ2L2z.js";
 typeof document < "u" && r();
 export {
   i as ListenerBag,