@thibezer/ui-components-kit 2.8.0 → 2.8.1

package/dist/components/ui-camadas/camadas-host.d.ts

@@ -12,6 +12,7 @@ export interface CamadasHostCompleto extends UICamadasHost {
     readonly mapaBaseAtivo: string;
     definirCamadaAtiva(camadaId: string, emitirEvento?: boolean): void;
     selecionarMapaBase(id: string, emitirEvento?: boolean): void;
+    alternarMapasBaseRecolhido(emitirEvento?: boolean): void;
     selecionarFeicao(feicaoId: string, acumular?: boolean, intervalo?: boolean, emitirEvento?: boolean): void;
     limparSelecao(emitirEvento?: boolean): void;
     notificarMudancaSelecao(): void;

package/dist/components/ui-camadas/camadas-mapas-base.d.ts

@@ -1,3 +1,5 @@
 import { MapaBaseItem } from './tipos';
 export declare const MAPAS_BASE_PADRAO: MapaBaseItem[];
-export declare function renderizarGridMapasBase(mapasBase?: MapaBaseItem[], mapaBaseAtivo?: string): string;
+/** Nome do mapa base ativo, para o cabeçalho da seção (vazio se o id não existir na lista). */
+export declare function nomeDoMapaBase(mapasBase: MapaBaseItem[], id: string): string;
+export declare function renderizarGridMapasBase(mapasBase?: MapaBaseItem[], mapaBaseAtivo?: string, recolhido?: boolean): string;

package/dist/components/ui-camadas/camadas-render.d.ts

@@ -8,6 +8,7 @@ export interface HostRenderizavel extends CamadasHostCompleto {
     editingFeatureId: string | null;
     readonly flutuante: boolean;
     readonly mostrarMapasBase: boolean;
+    readonly mapasBaseRecolhido: boolean;
     readonly mostrarRodape: boolean;
     getAttribute(nome: string): string | null;
 }

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

@@ -8,6 +8,18 @@ export declare const LIMITE_FEICOES_POR_CAMADA = 80;
  * Filtra feições pelo termo de busca (nome, categoria ou tipo). Sem termo, retorna todas.
  */
 export declare function filtrarFeicoesPorBusca(feicoes: FeicaoItem[], termo: string): FeicaoItem[];
+export interface ResultadoBuscaCamadas {
+    /** Camadas que permanecem na árvore: as que casam, seus ancestrais e as subcamadas de quem casa pelo nome. */
+    camadasVisiveis: Set<string>;
+    /** Feições mostradas em cada camada visível (todas, se a camada casa pelo nome; senão, só as que casam). */
+    feicoesPorCamada: Map<string, FeicaoItem[]>;
+}
+/**
+ * Busca em toda a árvore: casa pelo nome da camada ou pelos dados das feições (ver `filtrarFeicoesPorBusca`).
+ * Mantém os grupos ancestrais de cada resultado e, quando um grupo casa pelo nome, suas subcamadas.
+ * Sem termo, retorna `null` (nada a filtrar). Tolera nomes ausentes e ciclos de `parentId`.
+ */
+export declare function filtrarCamadasPorBusca(camadas: CamadaItem[], feicoes: FeicaoItem[], termo: string): ResultadoBuscaCamadas | null;
 /**
  * IDs de feições efetivamente exibidas na árvore, na ordem da tela:
  * respeita camadas expandidas (todas, durante uma busca), o filtro de busca e o limite de linhas.

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

@@ -40,6 +40,11 @@ export declare class UICamadas extends SafeHTMLElement implements CamadasHostCom
     set mapaBaseAtivo(valor: string);
     selecionarMapaBase(id: string, emitirEvento?: boolean): void;
     private marcarMapaBaseAtivoNoDOM;
+    /** Seção "Mapa Base" recolhida (só o cabeçalho com o mapa ativo). Atributo `mapas-base-recolhido`. */
+    get mapasBaseRecolhido(): boolean;
+    set mapasBaseRecolhido(valor: boolean);
+    /** Alterna a seção de mapas base; com `emitirEvento`, dispara `ui-mapas-base-recolhimento`. */
+    alternarMapasBaseRecolhido(emitirEvento?: boolean): void;
     get abaAtiva(): AbaPainelCamadas;
     set abaAtiva(aba: AbaPainelCamadas);
     get colapsado(): boolean;

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

@@ -9,6 +9,8 @@ export interface PortasPonteiro {
     interacaoAtiva: () => boolean;
     /** Se há ferramenta ativa, entrega a ela o botão direito e devolve `true` (não abre menu). */
     botaoDireitoDaFerramenta: () => boolean;
+    /** Pedido explícito de informações: abre o popup da feição. */
+    abrirPopup?: (feicao: Feicao) => void;
 }
 export declare class PonteiroFeicoes {
     private p;
@@ -19,6 +21,8 @@ export declare class PonteiroFeicoes {
     aoMoverMouse(e: MouseEvent): void;
     /** Botão direito: emite `cad-feicao-menu` com a feição sob o cursor (ou `null`), para o consumidor abrir o próprio menu. */
     menuContexto(e: MouseEvent): void;
+    /** Duplo clique sobre uma feição: pedido de informações (popup). Ignorado durante desenho ou edição de vértices. */
+    duploClique(e: MouseEvent): void;
     /** Esquece a feição sob o cursor (ao destruir o componente). */
     limpar(): void;
 }

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

@@ -11,6 +11,7 @@ import { EditorVertices } from '../../gerencigeo-canvas/feature_editor_vertices'
 import { ControleDesenho } from '../../gerencigeo-canvas/feature_desenho_controle';
 import { Ferramenta } from '../../gerencigeo-canvas/feature_desenho';
 import { MargensHud } from '../../gerencigeo-canvas/feature_hud';
+import { ModoPopups } from '../../gerencigeo-canvas/popup_gate';
 import { TIPO_CAMADA_FEICOES, OpcoesCamadaFeicoes, OpcoesLote, AtualizacaoFeicao, LoteFeicoes, ResultadoLote, ResultadoFeicoes, OpcoesPopup, ResultadoFerramenta, ResultadoEdicao } from './cad-feicoes-tipos';
 export { TIPO_CAMADA_FEICOES };
 export type { OpcoesCamadaFeicoes, OpcoesLote, AtualizacaoFeicao, LoteFeicoes, ResultadoLote, ResultadoFeicoes, OpcoesPopup, ResultadoFerramenta, ResultadoEdicao };
@@ -25,6 +26,13 @@ interface Contexto {
     aoFerramenta?: (ferramenta: Ferramenta | null) => void;
     /** Regra de oficial × prévia compartilhada com o renderizador (o componente a põe no contexto de renderização). */
     regra?: RegraVersoes;
+    /**
+     * Quando o popup da feição abre: `sob-demanda` (padrão do componente) só por duplo clique ou `abrirPopupFeicao`;
+     * `automatico` também ao selecionar uma feição. Sem esta função (uso direto do gerenciador), vale `automatico`.
+     */
+    modoPopups?: () => ModoPopups;
+    /** Executa a abertura de um popup como pedido explícito, passando pelo portão de popups do mapa. */
+    liberarPopups?: <T>(fn: () => T) => T;
 }
 export declare class GerenciadorFeicoes {
     private contexto;
@@ -80,6 +88,11 @@ export declare class GerenciadorFeicoes {
     selecionarNaCaixa(caixa: CaixaPx, modo: ModoCaixa, aditivo: boolean): void;
     definirMargensPopup(m: Partial<MargensPopup>): void;
     fecharPopup(): void;
+    private modoPopups;
+    /** Pedido explícito: abre o popup da feição (vale em qualquer modo). `false` se não existe, foi excluída ou não está na tela. */
+    abrirPopupFeicao(camadaId: string, id: string): boolean;
+    /** Duplo clique no mapa: abre o popup da feição sob o cursor (a não ser que os popups estejam desligados). */
+    aoDuploClique(e: MouseEvent): void;
     /** Opções do popup (hoje: se "copiar" escreve na área de transferência). Mescla com o que já foi definido. */
     definirOpcoesPopup(opcoes: OpcoesPopup): void;
     obterOpcoesPopup(): Required<OpcoesPopup>;

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

@@ -2,6 +2,7 @@ import { default as L } from 'leaflet';
 import { Ponto, Segmento, BancoPonto, Confrontante, CanvasLayerState, CanvasGraphicScale, ScaleMode, PontoCAD, ConexaoCAD, PoligonoCAD, DestacarElementoOpcoes } from '../../gerencigeo-canvas/types';
 import { GerenciGeoMapaController } from '../../gerencigeo-canvas/mapa_controller';
 import { CanvasLayerManager } from '../../gerencigeo-canvas/layer_manager';
+import { ModoPopups } from '../../gerencigeo-canvas/popup_gate';
 import { UsuarioRemoto } from '../../gerencigeo-canvas/feature_cursores';
 import { EventoMapaCad, LatLngEvento } from './tipos';
 import { PontoPixel } from './cad-evento-coordenadas';
@@ -72,6 +73,13 @@ export declare class UICanvasCAD extends SafeHTMLElement {
      */
     get aceitarOrigem(): boolean;
     set aceitarOrigem(val: boolean);
+    /**
+     * Quando os popups abrem (atributo `popups`): `sob-demanda` (padrão) só por duplo clique sobre a feição/camada ou por
+     * `abrirPopupFeicao()`, sem mover o mapa; `automatico` abre ao clicar e o Leaflet ajusta a vista (comportamento antigo);
+     * `desligado` só por `abrirPopupFeicao()`. Valor inválido usa o padrão.
+     */
+    get popups(): ModoPopups;
+    set popups(val: ModoPopups);
     get modoSequencial(): boolean;
     set modoSequencial(val: boolean);
     get chaveGrupo(): string | undefined;
@@ -82,6 +90,7 @@ export declare class UICanvasCAD extends SafeHTMLElement {
     set canalConfiguracao(val: string | null);
     fitBounds(pontos?: Ponto[], padding?: [number, number], incluirVizinhos?: boolean): void;
     zoomExtents(): void;
+    /** Seleciona o vértice. A vista só se move (e o popup abre) se `zoomLevel` for informado: é o pedido de "ir até o ponto". */
     selectPonto(id: string | number, zoomLevel?: number): void;
     selecionarPonto(id: string | number, zoomLevel?: number): void;
     get pontosSelecionados(): (string | number)[];
@@ -206,6 +215,8 @@ export declare class UICanvasCAD extends SafeHTMLElement {
     removerCursorRemoto(id: string): boolean;
     limparCursoresRemotos(): void;
     fecharPopupFeicao(): void;
+    /** Abre o popup da feição (pedido explícito, vale em qualquer modo de `popups`). `false` se ela não existe ou não está na tela. */
+    abrirPopupFeicao(camadaId: string, id: string): boolean;
     /**
      * Opções do popup. `copiarParaAreaDeTransferencia` (padrão `true`): a ação "copiar" também grava as coordenadas na área de
      * transferência; com `false` só sai `cad-feicao-acao` e o consumidor decide (ex.: para mostrar o próprio aviso).