@thibezer/ui-components-kit 2.12.0 → 2.12.3

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

@@ -24,6 +24,8 @@ export declare class CamadasDragDropManager {
     /** Depois de qualquer mudança na ordem/hierarquia de camadas. */
     private aposReordenarCamadas;
     private emitirFeicaoMovida;
+    /** Camada travada (ou sob grupo travado) não recebe nem perde feições pelo arraste. */
+    private trocaEntreCamadasTravada;
     private arrasteBloqueado;
     bindDragAndDrop(): void;
     /**

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

@@ -18,3 +18,13 @@ export declare function obterIdsSubarvoreCamada(camadas: CamadaItem[], camadaId:
  * Retorna todas as feições pertencentes à camada e às suas subcamadas descendentes.
  */
 export declare function obterFeicoesDoEscopoCamada(camadas: CamadaItem[], feicoes: FeicaoItem[], camadaId: string): FeicaoItem[];
+export interface EstadoHerdadoCamada {
+    /** Algum grupo acima está oculto: a camada não aparece no mapa, mesmo com o próprio olho aberto. */
+    ocultaPorAncestral: boolean;
+    /** Algum grupo acima está travado: a camada e as suas feições não podem ser editadas. */
+    travadaPorAncestral: boolean;
+}
+/** Estado que cada camada herda dos ancestrais. Tolera ciclos e pais inexistentes. */
+export declare function calcularEstadoHerdado(camadas: CamadaItem[]): Map<string, EstadoHerdadoCamada>;
+/** Ids das camadas travadas por si mesmas ou por um grupo acima delas. */
+export declare function idsCamadasTravadas(camadas: CamadaItem[]): Set<string>;

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

@@ -34,7 +34,12 @@ export interface EstadoPersistidoCamadas {
  */
 export declare function gerarChaveStorage(chaveProp?: string | null, elementId?: string | null): string;
 /**
- * Lê o estado persistido do localStorage com tolerância a falhas (SSR, restrições de sandbox)
+ * Valida o que veio do storage (editado à mão, de outra versão ou corrompido): campos com tipo errado
+ * caem para o padrão em vez de derrubar o painel. Algo que nem é objeto vira `null`.
+ */
+export declare function normalizarEstadoPersistido(bruto: unknown): EstadoPersistidoCamadas | null;
+/**
+ * Lê o estado persistido do localStorage com tolerância a falhas (SSR, restrições de sandbox, conteúdo corrompido)
  */
 export declare function carregarEstadoPersistido(storageKey: string): EstadoPersistidoCamadas | null;
 /**

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-sincronizacao-dom.d.ts

@@ -1,3 +1,8 @@
 import { CamadasHostCompleto } from './camadas-host';
 export declare function sincronizarCamadaAtivaDOM(host: CamadasHostCompleto, shadow: ShadowRoot): void;
 export declare function sincronizarSelecaoDOM(host: CamadasHostCompleto, shadow: ShadowRoot): void;
+/**
+ * Reflete no DOM o estado herdado dos grupos (sem redesenhar a árvore): esmaece o que está sob um
+ * grupo oculto e trava os cadeados das feições cuja camada, ou um grupo acima dela, está travada.
+ */
+export declare function sincronizarHerancaDOM(host: CamadasHostCompleto, shadow: ShadowRoot): void;

package/dist/components/ui-cores/ui-seletor-cor.d.ts

@@ -15,6 +15,8 @@ export type ConfiguracaoSeletorCor = Omit<OpcoesSeletorCor, 'ancora' | 'focar' |
 export declare class UISeletorCor extends SafeHTMLElement {
     private raiz;
     private listeners;
+    /** @internal Aberto por `abrirSeletorCor()`: solta os ouvintes de `window` se alguém remover o elemento. */
+    aoDesconectar: (() => void) | null;
     private _titulo;
     private _duplo;
     private _alvo;

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

@@ -2,6 +2,12 @@ import { ItemPropriedade, ContextoEditorPropriedade } from './tipos';
 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;
+/**
+ * Texto digitado num campo numérico → número final, ou `null` se inválido. Aceita a unidade
+ * da propriedade no fim ("25 mm", "90°"), aplica min/max e as casas decimais e remove o ruído
+ * de ponto flutuante (0.1 + 0.2 = 0.3).
+ */
+export declare function interpretarEntradaNumerica(texto: string, prop: ItemPropriedade): number | null;
 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;

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

@@ -25,8 +25,11 @@ export declare class GerenciadorValoresPropriedades {
     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;
+    /**
+     * Restaura uma propriedade individual ao seu valor original (antes da edição).
+     * Devolve `false` se não havia o que restaurar.
+     */
+    redefinirValor(propId: string, emitirEvento?: boolean): boolean;
     /** 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-render-arvore.d.ts

@@ -8,6 +8,8 @@ export interface ContextoLinhaPropriedade {
     isDirty?: boolean;
     editorCtx: ContextoEditorPropriedade;
     onAtualizarCampoVisual: (propId: string, novoValor: any) => void;
+    /** Restaura o valor original da propriedade (botão ↺ das linhas modificadas). */
+    onRedefinir?: (propId: string) => void;
 }
 export interface OpcoesRenderArvore {
     listaContainer: HTMLElement;

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

@@ -49,6 +49,12 @@ export interface SeletorTipoItem {
     subtipo?: string;
     iconeSvg?: string;
 }
+export interface UIAplicarDetail {
+    /** Todos os valores atuais. */
+    valores: Record<string, any>;
+    /** Só as propriedades que mudaram desde o último carregar/aplicar. */
+    alterados: Record<string, any>;
+}
 export interface UIPropertyChangeDetail {
     id: string;
     categoriaId: string;

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

@@ -63,6 +63,7 @@ export declare class UITabelaPropriedades extends SafeHTMLElement {
     set textoMisto(texto: string);
     get tipos(): SeletorTipoItem[];
     set tipos(novosTipos: SeletorTipoItem[]);
+    /** Id do tipo exibido no seletor: sem seleção válida, o seletor mostra (e devolve) o primeiro. */
     get tipoSelecionado(): string;
     set tipoSelecionado(idTipo: string);
     get valores(): Record<string, any>;
@@ -71,7 +72,11 @@ 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;
+    /**
+     * Volta uma propriedade ao valor do último carregar/aplicar (o mesmo que o botão ↺ da linha).
+     * Fora do modo manual emite `ui-propriedade-alterada`. Devolve `false` se não havia o que restaurar.
+     */
+    redefinirValor(propId: string, emitirEvento?: boolean): boolean;
     aplicar(): void;
     desfazer(): void;
     expandirTudo(): void;

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);
+}

package/dist/cores.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});;/* empty css                 */const r=require("./ui-seletor-cor-C4U2eqxY.cjs"),e=require("./ui-controle-cores-C8um-If9.cjs");exports.PALETA_CORES_PADRAO=r.PALETA_CORES_PADRAO;exports.UISeletorCor=r.UISeletorCor;exports.abrirSeletorCor=r.abrirSeletorCor;exports.coresUnicas=r.coresUnicas;exports.escaparHtml=r.escaparHtml;exports.fecharSeletorCor=r.fecharSeletorCor;exports.normalizarCor=r.normalizarCor;exports.normalizarEspessura=r.normalizarEspessura;exports.normalizarOpacidade=r.normalizarOpacidade;exports.UIControleCores=e.UIControleCores;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});;/* empty css                 */const r=require("./ui-seletor-cor-DPKqf5wb.cjs"),e=require("./ui-controle-cores-CuDFS8Y8.cjs");exports.PALETA_CORES_PADRAO=r.PALETA_CORES_PADRAO;exports.UISeletorCor=r.UISeletorCor;exports.abrirSeletorCor=r.abrirSeletorCor;exports.coresUnicas=r.coresUnicas;exports.escaparHtml=r.escaparHtml;exports.fecharSeletorCor=r.fecharSeletorCor;exports.normalizarCor=r.normalizarCor;exports.normalizarEspessura=r.normalizarEspessura;exports.normalizarOpacidade=r.normalizarOpacidade;exports.UIControleCores=e.UIControleCores;

package/dist/cores.js

@@ -1,6 +1,6 @@
 /* empty css               */
-import { P as s, U as e, a as l, c as t, e as i, f as m, n as C, b as c, d as n } from "./ui-seletor-cor-D2_C6Aor.js";
-import { U } from "./ui-controle-cores-B4R6ct4I.js";
+import { P as s, U as e, a as l, c as t, e as i, f as m, n as C, b as c, d as n } from "./ui-seletor-cor-FYtRccnK.js";
+import { U } from "./ui-controle-cores-C_cVXxCn.js";
 export {
   s as PALETA_CORES_PADRAO,
   U as UIControleCores,