@thibezer/ui-components-kit 2.11.1 → 2.12.2

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

@@ -12,6 +12,9 @@ export interface ParametrosRenderArvore {
     editingLayerId: string | null;
     editingFeatureId: string | null;
     searchQuery: string;
+    titulo?: string;
+    mostrarBusca?: boolean;
+    limitesPorCamada?: ReadonlyMap<string, number>;
     limiteFeicoesPorCamada?: number;
     mostrarBotaoColapsar?: boolean;
 }

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

@@ -17,7 +17,7 @@ export interface HostColecao {
     solicitarRenderizacao(): void;
 }
 /** Transforma a árvore (`children`) em lista plana, herdando `parentId` do pai quando não informado. */
-export declare function achatarCamadas(camadas: CamadaItem[], parentId?: string | null): CamadaItem[];
+export declare function achatarCamadas(camadas: CamadaItem[], parentId?: string | null, visitados?: Set<string>): CamadaItem[];
 export declare function definirCamadasNoHost(host: HostColecao, camadas: CamadaItem[], feicoes?: FeicaoItem[]): void;
 export declare function definirFeicoesNoHost(host: HostColecao, feicoes: FeicaoItem[]): void;
 export declare function adicionarCamadaNoHost(host: HostColecao, camada: CamadaItem): void;

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

@@ -8,9 +8,12 @@ export type ResultadoMoverCamada = {
     tipo: 'hierarquia';
     camada: CamadaItem;
     novoParentId: string;
+    parentAnteriorId: string | null;
 } | {
     tipo: 'ordem';
     camada: CamadaItem;
+    parentAnteriorId: string | null;
+    novoParentId: string | null;
 };
 /**
  * Move `movidaId` em relação a `alvoId`. `dentro` torna-a subcamada (recusa ciclos); `acima`/`abaixo`

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

@@ -1,2 +1,4 @@
 import { CamadasHostCompleto } from './camadas-host';
 export declare function conectarEventosCamadas(host: CamadasHostCompleto, shadow: ShadowRoot): void;
+/** Mantém o ícone do botão "expandir/recolher todas" coerente com o estado individual das camadas */
+export declare function atualizarIconeExpansaoGlobal(host: CamadasHostCompleto, shadow: ShadowRoot): void;

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

@@ -1,10 +1,20 @@
-import { CamadaItem } from './tipos';
+import { CamadaItem, FeicaoItem } from './tipos';
 export interface CamadaNodoHierarquico {
     camada: CamadaItem;
     depth: number;
     subcamadas: CamadaNodoHierarquico[];
 }
 /**
- * Organiza a lista de camadas em uma árvore hierárquica de nós baseada em parentId ou children
+ * Organiza a lista de camadas em uma árvore hierárquica de nós baseada em parentId ou children.
+ * Quebra ciclos de `parentId` promovendo o primeiro elo do ciclo a raiz, para que nenhuma camada suma
+ * nem cause estouro de pilha.
  */
 export declare function construirHierarquiaCamadas(camadas: CamadaItem[]): CamadaNodoHierarquico[];
+/**
+ * Retorna o conjunto de IDs da camada informada e de todas as suas subcamadas descendentes.
+ */
+export declare function obterIdsSubarvoreCamada(camadas: CamadaItem[], camadaId: string): Set<string>;
+/**
+ * Retorna todas as feições pertencentes à camada e às suas subcamadas descendentes.
+ */
+export declare function obterFeicoesDoEscopoCamada(camadas: CamadaItem[], feicoes: FeicaoItem[], camadaId: string): FeicaoItem[];

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

@@ -1,10 +1,13 @@
 import { UICamadasHost } from './camadas-drag-drop';
 export interface CamadasHostCompleto extends UICamadasHost {
     expandedLayers: Set<string>;
+    expandedFeatureLimits: Map<string, number>;
     selectedFeatureIds: Set<string>;
     lastClickedFeatureId: string | null;
     activeSettingsLayerId: string | null;
     searchQuery: string;
+    readonly titulo: string;
+    readonly mostrarBusca: boolean;
     salvarLembrancaEstado(): void;
     agendarSalvarLembranca(): void;
     colapsar(emitirEvento?: boolean): void;
@@ -14,9 +17,12 @@ export interface CamadasHostCompleto extends UICamadasHost {
     selecionarMapaBase(id: string, emitirEvento?: boolean): void;
     alternarMapasBaseRecolhido(emitirEvento?: boolean): void;
     selecionarFeicao(feicaoId: string, acumular?: boolean, intervalo?: boolean, emitirEvento?: boolean): void;
+    selecionarFeicoes(ids: string[], emitirEvento?: boolean): void;
     limparSelecao(emitirEvento?: boolean): void;
     notificarMudancaSelecao(): void;
     alternarVisibilidadeTodas(emitirEvento?: boolean): void;
+    alternarExpansao(camadaId: string): void;
+    incrementarLimiteFeicoes(camadaId: string): void;
     expandirTodas(): void;
     colapsarTodas(): void;
     removerCamada(camadaId: string): void;

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

@@ -8,7 +8,8 @@ export declare function calcularDistanciaPontos(p1: [number, number], p2: [numbe
  */
 export declare function calcularComprimentoLinha(coords: unknown): number;
 /**
- * Calcula a área de um único anel fechado de coordenadas em m² usando fórmula esférica
+ * Calcula a área de um único anel fechado de coordenadas em m² usando a Fórmula de Gauss (Shoelace)
+ * com projeção geodésica local na esfera WGS84.
  */
 export declare function calcularAreaAnelSimples(coords: unknown): number;
 /**

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

@@ -4,4 +4,9 @@ import { CamadaItem, FeicaoItem } from './tipos';
  * a hierarquia visual com recuo e ícones de pasta
  */
 export declare function formatarOpcoesCamadasHierarquicas(camadas: CamadaItem[]): string;
+/** Ícone + texto acessível do contador do rodapé (camadas ou feições selecionadas). */
+export declare function rotuloRodape(totalCamadas: number, totalSelecionadas: number): {
+    icone: string;
+    texto: string;
+};
 export declare function renderizarRodapeAcoes(camadas: CamadaItem[], feicoes: FeicaoItem[], selecionadasIds: Set<string>): string;

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

@@ -22,9 +22,9 @@ export interface ResultadoBuscaCamadas {
 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.
+ * respeita hierarquia da árvore, camadas expandidas (e seus ancestrais), o filtro de busca e o limite de linhas.
  */
-export declare function obterIdsVisiveisFeicoes(camadas: CamadaItem[], feicoes: FeicaoItem[], camadasExpandidas: Set<string>, termoBusca?: string, limitePorCamada?: number): string[];
+export declare function obterIdsVisiveisFeicoes(camadas: CamadaItem[], feicoes: FeicaoItem[], camadasExpandidas: Set<string>, termoBusca?: string, limitePorCamada?: number, limitesCustomizados?: ReadonlyMap<string, number>): string[];
 /**
  * Calcula a nova seleção após clique (simples, Ctrl/Cmd acumulado ou Shift em intervalo).
  * Retorna null se a feição clicada não estiver visível.

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

@@ -92,6 +92,7 @@ export interface DetalheEventoRenomearCamada {
 export interface DetalheEventoMoverHierarquiaCamada {
     camadaId: string;
     novoParentId: string | null;
+    parentAnteriorId?: string | null;
     camada?: CamadaItem;
 }
 export interface DetalheEventoFeicao {

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

@@ -20,6 +20,7 @@ export declare class UICamadas extends SafeHTMLElement implements CamadasHostCom
     feicoes: FeicaoItem[];
     mapasBase: MapaBaseItem[];
     expandedLayers: Set<string>;
+    expandedFeatureLimits: Map<string, number>;
     selectedFeatureIds: Set<string>;
     lastClickedFeatureId: string | null;
     activeSettingsLayerId: string | null;
@@ -102,6 +103,8 @@ export declare class UICamadas extends SafeHTMLElement implements CamadasHostCom
     limparSelecao(emitirEvento?: boolean): void;
     expandirTodas(): void;
     colapsarTodas(): void;
+    alternarExpansao(camadaId: string): void;
+    incrementarLimiteFeicoes(camadaId: string): void;
     alternarVisibilidadeTodas(emitirEvento?: boolean): void;
     colapsar(emitirEvento?: boolean): void;
     expandir(emitirEvento?: boolean): void;

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

@@ -1,5 +1,8 @@
 import { ItemPropriedade, ContextoEditorPropriedade } from './tipos';
-export declare function criarEditorReadonly(valorAtual: any, obterTextoMisto?: () => string): HTMLElement;
+export declare function obterCasasDecimais(prop: ItemPropriedade): number | undefined;
+export declare function obterPassoNumerico(prop: ItemPropriedade, casas?: number): number;
+export declare function aplicarLimitesNumericos(valor: number, prop: ItemPropriedade): number;
+export declare function criarEditorReadonly(valorAtual: any, obterTextoMisto?: () => string, prop?: ItemPropriedade): HTMLElement;
 export declare function criarEditorBooleano(categoriaId: string, prop: ItemPropriedade, valorAtual: any, ctx: ContextoEditorPropriedade): HTMLElement;
 export declare function criarEditorSelecao(categoriaId: string, prop: ItemPropriedade, valorAtual: any, ctx: ContextoEditorPropriedade): HTMLElement;
 export declare function criarEditorAcao(categoriaId: string, prop: ItemPropriedade, ctx: ContextoEditorPropriedade): HTMLElement;

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

@@ -22,6 +22,8 @@ export declare function sincronizarSelect(select: HTMLSelectElement, valor: any,
  */
 export declare function marcarSelectMisto(select: HTMLSelectElement, texto: string): void;
 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 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;

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

@@ -22,8 +22,11 @@ export declare class GerenciadorValoresPropriedades {
     getValoresOriginais(): Record<string, any>;
     setValores(novosValores: Record<string, any>): void;
     obterValor(propId: string): any;
+    obterValorOriginal(propId: string): any;
     /** Alteração programática: atualiza o editor na tela; não emite se o valor não mudou. */
     definirValor(propId: string, novoValor: any, emitirEvento?: boolean): void;
+    /** Restaura uma propriedade individual ao seu valor original (antes da edição). */
+    redefinirValor(propId: string, emitirEvento?: boolean): void;
     /** Alteração feita pelo usuário num editor. Em modo manual só emite no Aplicar. */
     registrarAlteracao(categoriaId: string, propId: string, novoValor: any): void;
     aplicar(): void;

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

@@ -10,6 +10,7 @@ export interface ContextoPainelControles {
     onAlternarDensidade?: () => void;
     onAlternarFlutuante?: () => void;
     onAlternarColapsoHorizontal?: () => void;
+    onFocarPrimeiroEditor?: () => void;
 }
 export declare function conectarPainelControles(ctx: ContextoPainelControles): void;
 export declare function sincronizarPainelControles(shadow: ShadowRoot, host: HTMLElement): void;

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

@@ -16,6 +16,16 @@ export interface ItemPropriedade {
     misto?: boolean;
     unidade?: string;
     casasDecimais?: number;
+    /** Alias para `casasDecimais`. */
+    precisao?: number;
+    /** Passo de incremento para teclado (ArrowUp/ArrowDown) e scrubber. */
+    passo?: number;
+    /** Alias para `passo`. */
+    step?: number;
+    /** Limite numérico mínimo permitido. */
+    min?: number;
+    /** Limite numérico máximo permitido. */
+    max?: number;
     opcoes?: OpcaoPropriedade[];
     placeholder?: string;
     somenteLeitura?: boolean;
@@ -28,6 +38,9 @@ export interface CategoriaPropriedades {
     id: string;
     titulo: string;
     aberto?: boolean;
+    /** Alias para `aberto`. */
+    aberta?: boolean;
+    icone?: string;
     propriedades: ItemPropriedade[];
 }
 export interface SeletorTipoItem {
@@ -47,6 +60,7 @@ export interface ContextoEditorPropriedade {
     obterValorAtual: (propId: string) => any;
     registrarAlteracao: (categoriaId: string, propId: string, novoValor: any) => void;
     focarProximoEditor: (elementoAtual: HTMLElement) => void;
+    focarEditorAnterior?: (elementoAtual: HTMLElement) => void;
     despacharEventoAcao: (prop: ItemPropriedade, categoriaId: string) => void;
     /** Texto exibido para valores mistos (atributo `texto-misto`); padrão "Varia". */
     obterTextoMisto?: () => string;

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

@@ -24,6 +24,7 @@ export declare class UITabelaPropriedades extends SafeHTMLElement {
     private _tipoSelecionadoId;
     private _termoBusca;
     private _larguraRotuloPorcentagem;
+    private _sincronizandoFlutuante;
     get larguraRotuloPorcentagem(): number;
     private tipoContainerElement;
     private corpoElement;
@@ -38,6 +39,20 @@ export declare class UITabelaPropriedades extends SafeHTMLElement {
      * `titulo`) tiraria o foco de um campo em edição.
      */
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    get titulo(): string;
+    set titulo(val: string);
+    get estiloVisual(): 'autocad' | 'revit';
+    set estiloVisual(val: 'autocad' | 'revit');
+    get modoAplicar(): 'imediato' | 'manual';
+    set modoAplicar(val: 'imediato' | 'manual');
+    get filtro(): boolean;
+    set filtro(val: boolean);
+    get termoBusca(): string;
+    set termoBusca(val: string);
+    get larguraRotulo(): number;
+    set larguraRotulo(pct: number);
+    get fechavel(): boolean;
+    set fechavel(val: boolean);
     get categorias(): CategoriaPropriedades[];
     set categorias(novasCategorias: CategoriaPropriedades[]);
     /**
@@ -56,6 +71,7 @@ export declare class UITabelaPropriedades extends SafeHTMLElement {
     get dirty(): boolean;
     obterValor(propId: string): any;
     definirValor(propId: string, novoValor: any, emitirEvento?: boolean): void;
+    redefinirValor(propId: string, emitirEvento?: boolean): void;
     aplicar(): void;
     desfazer(): void;
     expandirTudo(): void;
@@ -75,3 +91,7 @@ export declare class UITabelaPropriedades extends SafeHTMLElement {
     private renderSeletorTipos;
     private renderCategorias;
 }
+export declare class UIPainelPropriedades extends UITabelaPropriedades {
+}
+export declare class UIPropriedades extends UITabelaPropriedades {
+}

package/dist/components/ui-texto-editavel/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ui-texto-editavel';
+export * from './tipos';

package/dist/components/ui-texto-editavel/texto-editavel-teclado.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Trata atalhos de teclado no modo leitura (foco no botão do componente).
+ * Enter ou F2 ativam o modo de edição inline.
+ */
+export declare function tratarTecladoLeitura(evento: KeyboardEvent, iniciarEdicao: () => void): void;
+/**
+ * Trata atalhos de teclado no modo de edição (foco no input interno).
+ * - Enter: confirma e salva a edição.
+ * - Escape: cancela e restaura o valor original.
+ * - Tab: confirma e salva antes de permitir a mudança de foco natural.
+ */
+export declare function tratarTecladoEdicao(evento: KeyboardEvent, salvar: () => void, cancelar: () => void): void;

package/dist/components/ui-texto-editavel/texto-editavel-template.d.ts

@@ -0,0 +1,2 @@
+export declare const ATRIBUTOS_OBSERVADOS_TEXTO_EDITAVEL: readonly ["valor", "value", "placeholder", "variante", "tamanho", "disabled", "desabilitado", "readonly", "somente-leitura", "ao-perder-foco", "obrigatorio", "maxlength", "limite-caracteres", "name", "nome"];
+export declare function criarTemplateTextoEditavel(estilos: string): string;

package/dist/components/ui-texto-editavel/tipos.d.ts

@@ -0,0 +1,14 @@
+export type VarianteTextoEditavel = 'secundario' | 'secondary' | 'primario' | 'primary' | 'ghost' | 'terciario' | 'outline' | 'borda' | 'texto' | 'plano' | 'destaque' | 'destrutivo';
+export type TamanhoTextoEditavel = 'sm' | 'md' | 'lg';
+export type ModoTextoEditavel = 'leitura' | 'edicao';
+export type ComportamentoAoPerderFoco = 'salvar' | 'cancelar' | 'ignorar';
+export interface DetalheEventoSalvar {
+    valor: string;
+    valorAnterior: string;
+}
+export interface DetalheEventoCancelar {
+    valor: string;
+}
+export interface DetalheEventoModoAlterado {
+    modo: ModoTextoEditavel;
+}

package/dist/components/ui-texto-editavel/ui-texto-editavel.d.ts

@@ -0,0 +1,82 @@
+import { FormAssociatedElement } from '../../core/form-associated-element';
+import { VarianteTextoEditavel, TamanhoTextoEditavel, ComportamentoAoPerderFoco } from './tipos';
+/**
+ * Componente de texto ou botão que se transforma em campo de edição com duplo clique (ou atalhos de teclado).
+ *
+ * @element ui-texto-editavel
+ *
+ * @attr {string} valor - Valor textual atual.
+ * @attr {string} placeholder - Texto exibido quando o valor está vazio.
+ * @attr {string} variante - Estilo visual ('secundario', 'primario', 'ghost', 'outline', 'texto', etc.).
+ * @attr {string} tamanho - Tamanho do controle ('sm', 'md', 'lg').
+ * @attr {boolean} disabled - Desabilita o componente e impede edição.
+ * @attr {boolean} readonly - Permite focar e ler, mas impede entrar em edição.
+ * @attr {string} ao-perder-foco - Ação ao sair do campo ('salvar', 'cancelar', 'ignorar'). Padrão: 'salvar'.
+ * @attr {boolean} obrigatorio - Impede salvar com valor em branco.
+ * @attr {number} maxlength - Quantidade máxima de caracteres permitida.
+ *
+ * @fires ui-salvar - Disparado ao confirmar a edição com `{ valor, valorAnterior }`. Cancelável via preventDefault().
+ * @fires ui-cancelar - Disparado ao cancelar a edição com `{ valor }`.
+ * @fires ui-modo-alterado - Disparado quando alterna entre leitura e edição com `{ modo }`.
+ * @fires change - Disparado nativamente quando o valor é alterado e confirmado.
+ *
+ * @csspart base - O contêiner envolvente.
+ * @csspart botao - O botão do modo leitura.
+ * @csspart texto - O elemento de texto interno no modo leitura.
+ * @csspart input - O campo de entrada de texto nativo no modo edição.
+ */
+export declare class UITextoEditavel extends FormAssociatedElement {
+    static formAssociated: boolean;
+    static get observedAttributes(): readonly ["valor", "value", "placeholder", "variante", "tamanho", "disabled", "desabilitado", "readonly", "somente-leitura", "ao-perder-foco", "obrigatorio", "maxlength", "limite-caracteres", "name", "nome"];
+    private container;
+    private botaoElement;
+    private textoElement;
+    private inputElement;
+    private _modo;
+    private _concluindo;
+    private _valorInterno;
+    private _valorOriginalAoEditar;
+    private listeners;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(nome: string, _antigo: string | null, novo: string | null): void;
+    private handleDuploClique;
+    private handleKeyDownBotao;
+    private handleKeyDownInput;
+    private handleBlurInput;
+    /** Entra no modo de edição se o componente não estiver desabilitado ou em somente leitura. */
+    editar(): void;
+    /**
+     * Salva as alterações feitas no modo de edição e retorna ao modo leitura.
+     * Dispara `ui-salvar` (cancelável com preventDefault()).
+     */
+    salvar(): boolean;
+    /** Cancela as alterações e restaura o valor prévio à edição. */
+    cancelar(): void;
+    /** Informa se o componente está atualmente no modo de edição. */
+    estaEditando(): boolean;
+    private dispararEventoModo;
+    protected syncState(): void;
+    atualizarValidade(): void;
+    get valor(): string;
+    set valor(val: string);
+    get value(): string;
+    set value(val: string);
+    get placeholder(): string;
+    set placeholder(val: string);
+    get variante(): VarianteTextoEditavel;
+    set variante(val: VarianteTextoEditavel);
+    get tamanho(): TamanhoTextoEditavel;
+    set tamanho(val: TamanhoTextoEditavel);
+    get disabled(): boolean;
+    set disabled(val: boolean);
+    get readOnly(): boolean;
+    set readOnly(val: boolean);
+    get obrigatorio(): boolean;
+    set obrigatorio(val: boolean);
+    get aoPerderFoco(): ComportamentoAoPerderFoco;
+    set aoPerderFoco(val: ComportamentoAoPerderFoco);
+    get maxlength(): number | null;
+    set maxlength(val: number | null);
+}