@thibezer/ui-components-kit 2.13.0 → 2.15.0

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

@@ -46,5 +46,6 @@ export declare class EdicaoFeicoes {
     editarSelecionada(): boolean;
     /** Botão "Editar" da barra: encerra a edição em curso ou edita a feição selecionada (uma só). */
     alternarEdicaoDaSelecao(): ResultadoEdicao;
+    cancelar(): void;
     parar(): void;
 }

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

@@ -10,13 +10,16 @@ export interface PortasSelecaoRegiao {
     desenhada: (f: Feicao) => boolean;
     desativarFerramenta: () => void;
     selecionar: (refs: RefFeicao[]) => void;
+    adicionar?: (refs: RefFeicao[]) => void;
+    subtrair?: (refs: RefFeicao[]) => void;
     alternarVarias: (refs: RefFeicao[]) => void;
 }
+export type OperacaoSelecaoCaixa = 'substituir' | 'adicionar' | 'subtrair' | boolean;
 export declare class SelecaoPorRegiao {
     private p;
     constructor(p: PortasSelecaoRegiao);
     /** Laço: seleciona (substituindo) as feições de camadas selecionáveis tocadas pelo polígono; a ferramenta encerra. */
     selecionarNoLaco(laco: LatLonPar[]): void;
     /** Caixa de seleção: só feições de camadas visíveis, interativas e desbloqueadas, com toque geométrico real. */
-    selecionarNaCaixa(caixa: CaixaPx, modo: ModoCaixa, aditivo: boolean): void;
+    selecionarNaCaixa(caixa: CaixaPx, modo: ModoCaixa, operacao: OperacaoSelecaoCaixa): void;
 }

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

@@ -83,6 +83,7 @@ export declare class GerenciadorFeicoes {
         camadaId: string;
         feicao: Feicao;
         aditivo?: boolean;
+        subtrativo?: boolean;
     }): string | null;
     selecionarFeicoes(refs: RefFeicao[], aditivo?: boolean): void;
     alternarSelecaoFeicao(ref: RefFeicao): void;
@@ -93,7 +94,7 @@ export declare class GerenciadorFeicoes {
     /** Laço: seleciona (substituindo) as feições tocadas pelo polígono; a ferramenta encerra. */
     private selecionarNoLaco;
     /** Caixa de seleção: só feições de camadas visíveis, interativas e desbloqueadas, com toque geométrico real. */
-    selecionarNaCaixa(caixa: CaixaPx, modo: ModoCaixa, aditivo: boolean): void;
+    selecionarNaCaixa(caixa: CaixaPx, modo: ModoCaixa, operacao: import('./cad-feicoes-selecao-regiao').OperacaoSelecaoCaixa): void;
     definirMargensPopup(m: Partial<MargensPopup>): void;
     fecharPopup(): void;
     private modoPopups;

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

@@ -38,6 +38,8 @@ export declare class UICanvasCAD extends SafeHTMLElement {
     private _zonaProjecao;
     constructor();
     connectedCallback(): void;
+    private hudCoordAgendado;
+    private atualizarHudCoordenadas;
     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;

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