@thibezer/ui-components-kit 2.12.0 → 2.12.2

package/CHANGELOG.md

@@ -1,87 +1,101 @@
-# Changelog
-
-## 2.12.0 — 2026-10-26
-
-### `<ui-camadas>`: Verificação e Correção Profunda, Robustez e UX Avançada
-
-- **Proteção Numérica e Degradação Graciosa (Regra #0 do AGENTS.md)**:
-  - Eliminação de recursão infinita e loops em `construirHierarquiaCamadas` e `achatarCamadas`: proteção com detecção de ciclos via `Set` de nós visitados e quebra do ciclo elegendo a raiz sem perder camadas da árvore nem travar a UI.
-  - Correção do cálculo de área geodésica em `camadas-metricas.ts`: substituição da soma de produtos vetoriais de arestas por Shoelace projetado na esfera WGS84 com projeção local ($\phi_m$), blindagem contra `NaN`/`Infinity`, divisão por zero e clamp trigonométrico na distância esférica.
-  - Saneamento defensivo em `atualizarFeicaoNoHost`: proteção contra objetos `feicao` nulos ou indefinidos e clonagem segura de propriedades.
-- **Persistência Completa de Hierarquia**:
-  - `montarEstadoPersistido` e `aplicarEstadoPersistido` agora salvam e restauram `parentId`, impedindo o "desaninhamento" de subcamadas após reload da página. Saneamento preventivo contra reidratação de ciclos (`ehDescendente`).
-- **UX de Paginação Incremental ("Mostrar mais")**:
-  - Em camadas densas com centenas de feições, o componente limita a renderização inicial a 80 itens por camada e disponibiliza o botão "Mostrar mais (+80)" e o método público `incrementarLimiteFeicoes(camadaId)`.
-  - A seleção em intervalo (Shift+Clique) e seleções em lote respeitam estritamente a hierarquia real das subcamadas e o limite visível.
-- **Acessibilidade e Atalhos de Teclado**:
-  - `F2`: Inicia a renomeação inline da camada ou feição focada.
-  - `Ctrl+A` / `Cmd+A`: Seleciona todas as feições visíveis na árvore (respeitando busca ativa e nós colapsados).
-  - `Delete`: Aciona o fluxo de exclusão segura das feições selecionadas com confirmação em dois passos.
-  - `Escape`: Cancela o estado de confirmação pendente ou fecha o drawer lateral de configurações.
-- **Sincronização de Estado e Rodapé**:
-  - O alvo de seleção da camada (`ui-target-circle`) agora monitora a subárvore completa (camada pai e subcamadas filhas), aplicando corretamente os estados `selected`, `partial` ou vazio.
-  - O preview de cor do rodapé é atualizado com a cor real da primeira feição selecionada.
-  - O evento `ui-camada-mover-hierarquia` agora informa `parentAnteriorId` para rastreabilidade e histórico de operações.
-  - Adicionado método público `alternarExpansao(camadaId)`.
-- **Customização e Shadow Parts (`::part()`)**:
-  - Exposição de partes padronizadas: `base`, `corpo`, `toolbar`, `busca`, `arvore`, `grupo`, `camada`, `camada-ativa`, `feicao`, `feicao-selecionada`, `mapas-base`, `rodape`, `drawer`, `resizer` e `botao-expandir`.
-
-### `<ui-tabela-propriedades>`: Verificação e Correção Profunda, Robustez, UX e Acessibilidade CAD/Revit
-
-- **Proteção e Degradação Graciosa (Regra #0 do AGENTS.md)**:
-  - Higienização e tolerância a entradas hostis em `categorias` e `tipos` (itens `null`, propriedades sem rótulo ou malformadas são aceitas sem disparar `TypeError`).
-  - Blindagem do parser matemático contra divisão por zero, `NaN`, `Infinity` e estouro de pilha por parênteses recursivos profundos (`MAX_PROFUNDIDADE = 64`).
-  - Tratamento seguro de `flutuante`: prevenção contra ciclo de recursão de mutação em `attributeChangedCallback`.
-- **Motor Matemático e Expressões Inline CAD/Revit (`avaliador-expressao.ts`)**:
-  - Suporte a prefixo `=` opcional de fórmula (ex.: `=10.5 * 2 + (4 / 2)`).
-  - Suporte completo a números em notação científica (ex.: `1e-5`, `2.5e3`).
-  - Correção na avaliação contextual de porcentagem em termos compostos (`100 + 50 * 10% = 105`).
-  - Suporte a funções matemáticas avançadas: `min`, `max`, `pow`, `hypot`, `atan2`, `mod`, `trunc`, `sign`, `log`, `ln`, `deg`, `rad`.
-  - Preview visual em tempo real no atributo `title` do campo numérico enquanto uma fórmula é digitada (`.ui-prop__editor-input--calculando`).
-- **Ergonomia e UX Técnica (AutoCAD, Revit, Blender e Figma)**:
-  - Suporte a limites numéricos `min` e `max` em propriedades numéricas (com clamp automático na digitação, no teclado e no scrubber).
-  - Suporte a `passo` e `step` customizados para ajuste fino e grosso via setas `ArrowUp`/`ArrowDown` e scrubber.
-  - Suporte a aliases `precisao` (para `casasDecimais`) e `aberta` (para `aberto` em categorias).
-  - Exibição de dicas técnicas (`dica?: string` em `ItemPropriedade`) no `title` do rótulo e em `aria-description` do editor.
-  - Formatação e cópia de valores somente leitura (`readonly`), suportando casas decimais, resolução de labels de seleção e booleanos.
-  - Novo método público `redefinirValor(propId)` para reverter uma propriedade individual ao seu valor original sem descartar as demais alterações.
-  - Novo botão de limpar busca (`#btn-limpar-filtro`) e atalho `Escape` para limpar o filtro de busca instantaneamente.
-  - Busca expandida: agora localiza propriedades também pelo título da categoria (`cat.titulo`) e pelo valor atual.
-  - Exibição de estado vazio informativo quando nenhum resultado coincidir com o filtro.
-  - Atalho `Ctrl+Enter` / `Cmd+Enter` para aplicar alterações no modo manual.
-  - Tecla `Escape` durante a edição de campos numéricos e de texto cancela a alteração sem propagar o evento para modais ou overlays pais.
-  - Suporte a `Shift+Enter` para navegar ao editor anterior, e navegação restrita estritamente a editores visíveis de categorias abertas.
-- **Acessibilidade e WAI-ARIA**:
-  - Splitter vertical (`#splitter`) agora é um separador acessível (`role="separator"`, `tabindex="0"`, `aria-orientation="vertical"`, `aria-valuenow` dinâmico) ajustável via teclado com `ArrowLeft`, `ArrowRight`, `Home`, `End` e `Enter` para restaurar os 45% padrão.
-  - Cabeçalhos de categorias (`.ui-prop__categoria-header`) navegáveis por teclado via `ArrowDown`, `ArrowUp`, `ArrowLeft` (recolhe), `ArrowRight` (expande), `Home` e `End`.
-  - Correção de contraste para conformidade WCAG AA no tema claro (`[data-tema="claro"]`).
-  - Adição de `aria-label` descritivo nos seletores de tipo e de linha.
-- **Shadow Parts (`::part()`) e Registro de Aliases**:
-  - Exposição completa de shadow parts: `base`, `faixa-estreita`, `cabecalho`, `titulo`, `acoes-cabecalho`, `seletor-tipo`, `filtro`, `filtro-input`, `splitter`, `corpo`, `lista-categorias`, `vazio`, `categoria`, `categoria-aberta`, `categoria-cabecalho`, `categoria-conteudo`, `linha`, `linha-modificada`, `linha-mista`, `rotulo`, `valor`, `editor`, `unidade`, `rodape`, `ajuda`, `desfazer`, `aplicar`.
-  - Registro oficial dos Custom Elements aliases `<ui-painel-propriedades>` e `<ui-propriedades>` (classes `UIPainelPropriedades` e `UIPropriedades`), com tipagem completa gerada para HTML nativo, React e Vue.
-
-
-## 2.11.1 — 2026-10-23
-
-Junta à 2.11.0 o que estava fora do npm (PR #14): o redesign compacto do seletor de cor no estilo Illustrator.
-
-### `<ui-seletor-cor>`: painel mais compacto, campos no estilo Illustrator
-
-- Opacidade e espessura do traçado viram **campos numéricos** compactos (rótulo à esquerda, campo com setas ▲▼ e unidade `%`/`px`), no lugar das faixas deslizantes e dos atalhos (25–100 % e 1–8 px). No campo: ↑/↓ e a roda do mouse (com o campo em foco) somam um passo (1 % ou 0,5 px), Shift soma dez; o valor digitado ("50", "50%", "2,5 px") vale no Enter, no Tab ou ao sair; texto inválido volta ao valor atual sem emitir evento. Enter no campo não fecha o seletor.
-- "Sem cor" deixa de ser um botão largo com texto e vira uma amostra quadrada de 30 px (fundo neutro com diagonal vermelha, como o *None* do Illustrator) ao lado do hexadecimal e do seletor do sistema; mantém a classe `.sem-cor`, `data-cor="none"`, `aria-pressed` e o rótulo acessível.
-- Saem as amostras "Cores do projeto" e "Paleta padrão". As opções `coresProjeto` e `paleta` de `abrirSeletorCor()`/`configurar()`, a propriedade `coresProjeto` do `<ui-controle-cores>` e a constante `PALETA_CORES_PADRAO` continuam aceitas, mas ficam obsoletas (`@deprecated`) e são ignoradas pelo seletor.
-
-## 2.11.0 — 2026-10-23
-
-### `<ui-canvas-cad>`: personalização da linha padrão (tipos de linha CAD)
-
-- **Tipos de linha estilo CAD** (`tipoLinha`): `continua`, `tracejada`, `tracejada-curta`, `tracejada-longa`, `pontilhada`, `traco-ponto`, `traco-ponto-ponto`, `oculta`, `centro`, `fantasma` e `divisa`. Os nomes do AutoCAD (`Dashed`, `Hidden`, `Center`, `Phantom`...) também valem, inclusive os do editor de tipo de linha do `<ui-tabela-propriedades>`.
-- **Novas opções de traço** em `EstiloFeicao`: `tipoLinha`, `escalaTipoLinha` (LTSCALE), `deslocamentoTracejado`, `opacidadeTraco`, `terminacaoTraco` (`arredondada`/`reta`/`quadrada`) e `juncaoTraco` (`arredondada`/`chanfrada`/`angular`). Em `LayerStyleDef`, como padrão da camada: `tipoLinha`, `escalaTipoLinha`, `opacidadeLinha`, `terminacaoLinha` e `juncaoLinha`. Valem nos renderizadores `leaflet` e `canvas`.
-- **Linha padrão do componente**: atributos `linha-cor`, `linha-espessura`, `linha-tipo`, `linha-escala`, `linha-tracejado`, `linha-deslocamento`, `linha-opacidade`, `linha-terminacao` e `linha-juncao`, e os métodos `definirLinhaPadrao(opcoes)` / `obterLinhaPadrao()` (tipo `OpcoesLinhaPadrao`). Gravam no estilo de desenho: as feições desenhadas daqui para frente saem com essa linha.
-- O conta-gotas copia também as novas opções.
-- Entrada hostil: valor inválido não é aplicado (a opção volta ao padrão); cor e tracejado são saneados; `null` remove a opção. Feição selecionada sempre tem traço opaco.
-- Utilitários puros em `gerencigeo-canvas`: `TIPOS_LINHA`, `normalizarTipoLinha`, `dashTipoLinha`, `escalaTipoLinhaSegura`, `terminacaoCanvas`, `juncaoCanvas`. `EstiloVetor` ganha os campos opcionais `opacidadeTraco`, `terminacao`, `juncao` e `deslocamentoDash`.
-- Guia: [`docs/linha-padrao-cad.md`](docs/linha-padrao-cad.md).
+# Changelog
+
+## 2.12.2 — 2026-10-30
+
+### `<ui-camadas>`: cabeçalho e rodapé simplificados
+
+- **Barras unificadas**: cabeçalho (título + contador) e rodapé usam a mesma altura (`--camada-barra-altura`, 28px), coladas nas bordas do painel e com linha divisória de ponta a ponta.
+- **Botões sem borda dupla**: olho, chevron, `Grupo` e `Camada` perdem a borda própria; ficam só com fundo sutil.
+- **Criação no rodapé**: `Grupo` e `Camada` saíram da toolbar do topo e ficam à direita do rodapé (eventos `ui-camada-adicionar` e `ui-camada-grupo-adicionar` inalterados). Os ids `btn-add-layer` e `btn-add-group` deixam de existir; use `btn-footer-new-layer` e `btn-footer-new-group`.
+- **Rodapé enxuto**: o texto "N camadas" virou ícone de camadas + número (o texto fica em `title`/`aria-label`). Saíram o olho e o cadeado coletivos, a bolinha de cor, a métrica de área e o botão "X" (o `Esc` limpa a seleção).
+- **Ações em massa**: `visibilidade`, `bloqueio` e `cor` deixam de ser disparadas pelo painel; seguem `mover` e `excluir`. O seletor de camada de destino ocupa o espaço livre.
+
+### `<ui-texto-editavel>` (novo)
+
+- Novo componente de texto editável inline, exportado em `src/index.ts` e registrado em `src/register.ts`.
+
+## 2.12.0 — 2026-10-26
+
+### `<ui-camadas>`: Verificação e Correção Profunda, Robustez e UX Avançada
+
+- **Proteção Numérica e Degradação Graciosa (Regra #0 do AGENTS.md)**:
+  - Eliminação de recursão infinita e loops em `construirHierarquiaCamadas` e `achatarCamadas`: proteção com detecção de ciclos via `Set` de nós visitados e quebra do ciclo elegendo a raiz sem perder camadas da árvore nem travar a UI.
+  - Correção do cálculo de área geodésica em `camadas-metricas.ts`: substituição da soma de produtos vetoriais de arestas por Shoelace projetado na esfera WGS84 com projeção local ($\phi_m$), blindagem contra `NaN`/`Infinity`, divisão por zero e clamp trigonométrico na distância esférica.
+  - Saneamento defensivo em `atualizarFeicaoNoHost`: proteção contra objetos `feicao` nulos ou indefinidos e clonagem segura de propriedades.
+- **Persistência Completa de Hierarquia**:
+  - `montarEstadoPersistido` e `aplicarEstadoPersistido` agora salvam e restauram `parentId`, impedindo o "desaninhamento" de subcamadas após reload da página. Saneamento preventivo contra reidratação de ciclos (`ehDescendente`).
+- **UX de Paginação Incremental ("Mostrar mais")**:
+  - Em camadas densas com centenas de feições, o componente limita a renderização inicial a 80 itens por camada e disponibiliza o botão "Mostrar mais (+80)" e o método público `incrementarLimiteFeicoes(camadaId)`.
+  - A seleção em intervalo (Shift+Clique) e seleções em lote respeitam estritamente a hierarquia real das subcamadas e o limite visível.
+- **Acessibilidade e Atalhos de Teclado**:
+  - `F2`: Inicia a renomeação inline da camada ou feição focada.
+  - `Ctrl+A` / `Cmd+A`: Seleciona todas as feições visíveis na árvore (respeitando busca ativa e nós colapsados).
+  - `Delete`: Aciona o fluxo de exclusão segura das feições selecionadas com confirmação em dois passos.
+  - `Escape`: Cancela o estado de confirmação pendente ou fecha o drawer lateral de configurações.
+- **Sincronização de Estado e Rodapé**:
+  - O alvo de seleção da camada (`ui-target-circle`) agora monitora a subárvore completa (camada pai e subcamadas filhas), aplicando corretamente os estados `selected`, `partial` ou vazio.
+  - O preview de cor do rodapé é atualizado com a cor real da primeira feição selecionada.
+  - O evento `ui-camada-mover-hierarquia` agora informa `parentAnteriorId` para rastreabilidade e histórico de operações.
+  - Adicionado método público `alternarExpansao(camadaId)`.
+- **Customização e Shadow Parts (`::part()`)**:
+  - Exposição de partes padronizadas: `base`, `corpo`, `toolbar`, `busca`, `arvore`, `grupo`, `camada`, `camada-ativa`, `feicao`, `feicao-selecionada`, `mapas-base`, `rodape`, `drawer`, `resizer` e `botao-expandir`.
+
+### `<ui-tabela-propriedades>`: Verificação e Correção Profunda, Robustez, UX e Acessibilidade CAD/Revit
+
+- **Proteção e Degradação Graciosa (Regra #0 do AGENTS.md)**:
+  - Higienização e tolerância a entradas hostis em `categorias` e `tipos` (itens `null`, propriedades sem rótulo ou malformadas são aceitas sem disparar `TypeError`).
+  - Blindagem do parser matemático contra divisão por zero, `NaN`, `Infinity` e estouro de pilha por parênteses recursivos profundos (`MAX_PROFUNDIDADE = 64`).
+  - Tratamento seguro de `flutuante`: prevenção contra ciclo de recursão de mutação em `attributeChangedCallback`.
+- **Motor Matemático e Expressões Inline CAD/Revit (`avaliador-expressao.ts`)**:
+  - Suporte a prefixo `=` opcional de fórmula (ex.: `=10.5 * 2 + (4 / 2)`).
+  - Suporte completo a números em notação científica (ex.: `1e-5`, `2.5e3`).
+  - Correção na avaliação contextual de porcentagem em termos compostos (`100 + 50 * 10% = 105`).
+  - Suporte a funções matemáticas avançadas: `min`, `max`, `pow`, `hypot`, `atan2`, `mod`, `trunc`, `sign`, `log`, `ln`, `deg`, `rad`.
+  - Preview visual em tempo real no atributo `title` do campo numérico enquanto uma fórmula é digitada (`.ui-prop__editor-input--calculando`).
+- **Ergonomia e UX Técnica (AutoCAD, Revit, Blender e Figma)**:
+  - Suporte a limites numéricos `min` e `max` em propriedades numéricas (com clamp automático na digitação, no teclado e no scrubber).
+  - Suporte a `passo` e `step` customizados para ajuste fino e grosso via setas `ArrowUp`/`ArrowDown` e scrubber.
+  - Suporte a aliases `precisao` (para `casasDecimais`) e `aberta` (para `aberto` em categorias).
+  - Exibição de dicas técnicas (`dica?: string` em `ItemPropriedade`) no `title` do rótulo e em `aria-description` do editor.
+  - Formatação e cópia de valores somente leitura (`readonly`), suportando casas decimais, resolução de labels de seleção e booleanos.
+  - Novo método público `redefinirValor(propId)` para reverter uma propriedade individual ao seu valor original sem descartar as demais alterações.
+  - Novo botão de limpar busca (`#btn-limpar-filtro`) e atalho `Escape` para limpar o filtro de busca instantaneamente.
+  - Busca expandida: agora localiza propriedades também pelo título da categoria (`cat.titulo`) e pelo valor atual.
+  - Exibição de estado vazio informativo quando nenhum resultado coincidir com o filtro.
+  - Atalho `Ctrl+Enter` / `Cmd+Enter` para aplicar alterações no modo manual.
+  - Tecla `Escape` durante a edição de campos numéricos e de texto cancela a alteração sem propagar o evento para modais ou overlays pais.
+  - Suporte a `Shift+Enter` para navegar ao editor anterior, e navegação restrita estritamente a editores visíveis de categorias abertas.
+- **Acessibilidade e WAI-ARIA**:
+  - Splitter vertical (`#splitter`) agora é um separador acessível (`role="separator"`, `tabindex="0"`, `aria-orientation="vertical"`, `aria-valuenow` dinâmico) ajustável via teclado com `ArrowLeft`, `ArrowRight`, `Home`, `End` e `Enter` para restaurar os 45% padrão.
+  - Cabeçalhos de categorias (`.ui-prop__categoria-header`) navegáveis por teclado via `ArrowDown`, `ArrowUp`, `ArrowLeft` (recolhe), `ArrowRight` (expande), `Home` e `End`.
+  - Correção de contraste para conformidade WCAG AA no tema claro (`[data-tema="claro"]`).
+  - Adição de `aria-label` descritivo nos seletores de tipo e de linha.
+- **Shadow Parts (`::part()`) e Registro de Aliases**:
+  - Exposição completa de shadow parts: `base`, `faixa-estreita`, `cabecalho`, `titulo`, `acoes-cabecalho`, `seletor-tipo`, `filtro`, `filtro-input`, `splitter`, `corpo`, `lista-categorias`, `vazio`, `categoria`, `categoria-aberta`, `categoria-cabecalho`, `categoria-conteudo`, `linha`, `linha-modificada`, `linha-mista`, `rotulo`, `valor`, `editor`, `unidade`, `rodape`, `ajuda`, `desfazer`, `aplicar`.
+  - Registro oficial dos Custom Elements aliases `<ui-painel-propriedades>` e `<ui-propriedades>` (classes `UIPainelPropriedades` e `UIPropriedades`), com tipagem completa gerada para HTML nativo, React e Vue.
+
+
+## 2.11.1 — 2026-10-23
+
+Junta à 2.11.0 o que estava fora do npm (PR #14): o redesign compacto do seletor de cor no estilo Illustrator.
+
+### `<ui-seletor-cor>`: painel mais compacto, campos no estilo Illustrator
+
+- Opacidade e espessura do traçado viram **campos numéricos** compactos (rótulo à esquerda, campo com setas ▲▼ e unidade `%`/`px`), no lugar das faixas deslizantes e dos atalhos (25–100 % e 1–8 px). No campo: ↑/↓ e a roda do mouse (com o campo em foco) somam um passo (1 % ou 0,5 px), Shift soma dez; o valor digitado ("50", "50%", "2,5 px") vale no Enter, no Tab ou ao sair; texto inválido volta ao valor atual sem emitir evento. Enter no campo não fecha o seletor.
+- "Sem cor" deixa de ser um botão largo com texto e vira uma amostra quadrada de 30 px (fundo neutro com diagonal vermelha, como o *None* do Illustrator) ao lado do hexadecimal e do seletor do sistema; mantém a classe `.sem-cor`, `data-cor="none"`, `aria-pressed` e o rótulo acessível.
+- Saem as amostras "Cores do projeto" e "Paleta padrão". As opções `coresProjeto` e `paleta` de `abrirSeletorCor()`/`configurar()`, a propriedade `coresProjeto` do `<ui-controle-cores>` e a constante `PALETA_CORES_PADRAO` continuam aceitas, mas ficam obsoletas (`@deprecated`) e são ignoradas pelo seletor.
+
+## 2.11.0 — 2026-10-23
+
+### `<ui-canvas-cad>`: personalização da linha padrão (tipos de linha CAD)
+
+- **Tipos de linha estilo CAD** (`tipoLinha`): `continua`, `tracejada`, `tracejada-curta`, `tracejada-longa`, `pontilhada`, `traco-ponto`, `traco-ponto-ponto`, `oculta`, `centro`, `fantasma` e `divisa`. Os nomes do AutoCAD (`Dashed`, `Hidden`, `Center`, `Phantom`...) também valem, inclusive os do editor de tipo de linha do `<ui-tabela-propriedades>`.
+- **Novas opções de traço** em `EstiloFeicao`: `tipoLinha`, `escalaTipoLinha` (LTSCALE), `deslocamentoTracejado`, `opacidadeTraco`, `terminacaoTraco` (`arredondada`/`reta`/`quadrada`) e `juncaoTraco` (`arredondada`/`chanfrada`/`angular`). Em `LayerStyleDef`, como padrão da camada: `tipoLinha`, `escalaTipoLinha`, `opacidadeLinha`, `terminacaoLinha` e `juncaoLinha`. Valem nos renderizadores `leaflet` e `canvas`.
+- **Linha padrão do componente**: atributos `linha-cor`, `linha-espessura`, `linha-tipo`, `linha-escala`, `linha-tracejado`, `linha-deslocamento`, `linha-opacidade`, `linha-terminacao` e `linha-juncao`, e os métodos `definirLinhaPadrao(opcoes)` / `obterLinhaPadrao()` (tipo `OpcoesLinhaPadrao`). Gravam no estilo de desenho: as feições desenhadas daqui para frente saem com essa linha.
+- O conta-gotas copia também as novas opções.
+- Entrada hostil: valor inválido não é aplicado (a opção volta ao padrão); cor e tracejado são saneados; `null` remove a opção. Feição selecionada sempre tem traço opaco.
+- Utilitários puros em `gerencigeo-canvas`: `TIPOS_LINHA`, `normalizarTipoLinha`, `dashTipoLinha`, `escalaTipoLinhaSegura`, `terminacaoCanvas`, `juncaoCanvas`. `EstiloVetor` ganha os campos opcionais `opacidadeTraco`, `terminacao`, `juncao` e `deslocamentoDash`.
+- Guia: [`docs/linha-padrao-cad.md`](docs/linha-padrao-cad.md).
 
 ## 2.10.1 — 2026-10-23