@thibezer/ui-components-kit 2.3.0 → 2.4.0

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

@@ -60,6 +60,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;
+    /** A edição de vértices começou (`true`) ou terminou (`false`), para refletir no botão da barra. */
+    aoEdicao?: (ativa: boolean) => void;
+    /**
+     * Os atalhos de teclado do canvas (S do snap, Enter para editar) valem agora? O componente responde que sim com o mouse
+     * sobre ele ou o foco dentro dele; sem esta função, valem sempre (a edição e as ferramentas em andamento também sempre valem).
+     */
+    atalhoValido?: () => boolean;
 }
 /** Opções do popup da feição. */
 export interface OpcoesPopup {
@@ -72,13 +79,14 @@ export interface ResultadoFerramenta {
 }
 export interface ResultadoEdicao {
     ok: boolean;
-    motivo?: MotivoRecusaEdicao | 'inexistente' | 'sem-mapa';
+    motivo?: MotivoRecusaEdicao | 'inexistente' | 'sem-mapa' | 'sem-selecao';
 }
 export declare class GerenciadorFeicoes {
     private contexto;
     private selecao;
     private popup;
     private editor;
+    private vigiaCamadaEmEdicao;
     private snap;
     private desenho;
     private camadaDesenho;
@@ -194,12 +202,18 @@ export declare class GerenciadorFeicoes {
     alternarSnap(): void;
     conectarTeclado(): void;
     desconectarTeclado(): void;
+    private atalhosValem;
+    /** Enter com uma só feição selecionada (e nada em andamento) abre a edição de vértices. */
+    private aoTeclaEdicao;
+    /** Botão "Editar" da barra: encerra a edição em curso ou edita a feição selecionada (uma só). */
+    alternarEdicaoDaSelecao(): ResultadoEdicao;
     /** Feições visíveis das camadas de feições cujo envelope toca um quadrado de `tolPx` px em volta de `coord`. */
     private candidatasEm;
     /** Snap de uma coordenada contra as feições visíveis de todas as camadas de feições (via índice espacial). */
     buscarSnapEm(coord: [number, number], excluir?: ExcluirSnap): import('../../gerencigeo-canvas').ResultadoSnap | null;
     get editando(): boolean;
     iniciarEdicao(camadaId: string, id: string): ResultadoEdicao;
+    private pararDeVigiarCamadaEmEdicao;
     pararEdicao(): void;
     get ferramentaAtiva(): Ferramenta | null;
     /** Camada que recebe o que for desenhado. Não existe camada padrão: o consumidor escolhe. */

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

@@ -1,15 +1,22 @@
 import { Ferramenta } from '../../gerencigeo-canvas/feature_desenho';
 /** Interpreta o atributo; nomes desconhecidos são ignorados e a ordem da barra é sempre a canônica. */
 export declare function interpretarFerramentas(valor: string | null): Ferramenta[];
+/** O atributo pede o botão "Editar" (edição de vértices da feição selecionada)? Vale em "todas" ou com a palavra `editar`. */
+export declare function barraPedeEdicao(valor: string | null): boolean;
 export interface ContextoBarraFerramentas {
     raiz: HTMLElement;
     aoEscolher: (ferramenta: Ferramenta) => void;
+    /** Clique em "Editar". Sem isto o botão não é montado. */
+    aoEditar?: () => void;
 }
 export declare class BarraFerramentas {
     private ctx;
     private barra;
     constructor(ctx: ContextoBarraFerramentas);
-    montar(ferramentas: Ferramenta[]): void;
+    montar(ferramentas: Ferramenta[], comEdicao?: boolean): void;
+    private editando;
+    /** Reflete no botão "Editar" se a edição está em curso. */
+    marcarEdicao(ativa: boolean): void;
     marcar(ativa: Ferramenta | null): void;
     desmontar(): void;
 }

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

@@ -5,6 +5,8 @@ export interface ContextoControleSnap {
         ligado: boolean;
         temporario: boolean;
     }) => void;
+    /** A tecla S só vale quando isto devolve `true` (ex.: mouse sobre o canvas ou foco dentro dele). Sem a função, vale sempre. */
+    aplica?: () => boolean;
     /** Alvo dos listeners de teclado (padrão: window). */
     alvo?: Pick<Window, 'addEventListener' | 'removeEventListener'>;
 }

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

@@ -25,10 +25,17 @@ export declare class UICanvasCAD extends SafeHTMLElement {
     private estilosExternos;
     private lastPopupActionEmit?;
     private lastCanvasClickTime;
+    /** Mouse sobre o componente: junto com o foco dentro dele, decide se S e Enter valem quando há vários canvases na página. */
+    private ponteiroSobre;
     private _chaveGrupo?;
     private _zonaProjecao;
     constructor();
     connectedCallback(): void;
+    private montarBarra;
+    /** Único canvas da página: os atalhos valem em qualquer lugar (comportamento de sempre). Com vários, só no que está sob o mouse ou com foco. */
+    private ehUnicoCanvas;
+    /** O foco do teclado está dentro do componente (inclusive no shadow DOM)? */
+    private matchesFocoInterno;
     destroy(): void;
     disconnectedCallback(): void;
     invalidateSizeSafely(): void;