[general]
name=GeoSketch
qgisMinimumVersion=3.34
description=Draw, measure and organize field geometries with a simple, satellite-imagery-style workflow and automatic GeoPackage storage
about=O GeoSketch é um complemento para QGIS desenvolvido para facilitar a criação, edição e organização de geometrias diretamente no mapa.

    Oferece ferramentas para criação de pontos, polígonos, caminhos e círculos, medição de áreas e distâncias, gerenciamento de estilos e operações de geoprocessamento.

    Também disponibiliza validação de geometrias, exportação de mapas em PDF e PNG, além de importação e exportação de arquivos KML e KMZ.

    Todos os dados são organizados e salvos automaticamente em um GeoPackage, com suporte à organização por pastas e subpastas.
version=1.9.0
author=Gabriel Alberto
email=gabriel.alberto0818@gmail.com

homepage=https://github.com/GabrielSa95/GeoSketch
tracker=https://github.com/GabrielSa95/GeoSketch/issues
repository=https://github.com/GabrielSa95/GeoSketch

tags=vector,digitizing,measurement,survey,sketch,geoprocessing,buffer,validation,kml,placemark,polygon,geopackage
category=Vector
icon=icons/geosketch.png
experimental=False
deprecated=False

changelog=1.9.0
    Correcoes dos apontamentos do repositorio oficial do QGIS: Bandit
    ("Try, Except, Continue detected" em snapping.py::_nearby_segments -
    agora so' chama edgePoints() quando hasEdge() e' verdadeiro e
    captura apenas ValueError, registrando via utils.log em vez de
    engolir a excecao) e Qt6 (enum achatado QgsWkbTypes.PolygonGeometry
    em earth_tools.py::_representative_point trocado pela forma
    qualificada QgsWkbTypes.GeometryType.PolygonGeometry, ja usada em
    geoprocessing.py). Nenhuma funcionalidade foi alterada.
    1.8.0
    Marcador em pino, desempenho na edicao de vertices, identidade do
    produto e visualizacao 3D:
    - Novo icone de marcador de ponto: pino vetorial (SVG proprio, nao
      copiado de terceiros) com ponta inferior ancorada exatamente sobre
      a coordenada geografica (confirmado por renderizacao real em
      QgsMapCanvas), no lugar do circulo simples anterior. Respeita as
      cores escolhidas pelo usuario; nao altera a geometria armazenada;
      poligonos e linhas continuam com os simbolos de sempre.
    - CORRECAO DE DESEMPENHO: a edicao de vertices reconstruia TODOS os
      marcadores (QgsVertexMarker) a cada minimo ajuste, mesmo quando so'
      um vertice mudava de posicao - o custo dominante era inserir/
      remover itens na QGraphicsScene do canvas, nao o calculo em si.
      Agora os marcadores existentes sao reaproveitados (so' reposicionados/
      recoloridos) quando a quantidade de vertices nao muda. Medido contra
      o QGIS 3.44.15 real (media de 30-60 repeticoes, so' 1 vertice
      alterado por chamada):
        vertices |  antes   |  depois
        10       |  0.23 ms |  0.04 ms
        100      |  2.29 ms |  0.35 ms
        500      |  6.79 ms |  1.36 ms
        2000     | 37.99 ms |  6.40 ms
        5000     |150.66 ms | 17.37 ms
      (aderencia inteligente com varias camadas visiveis foi medida
      separadamente e ja estava com desempenho aceitavel - nenhuma
      alteracao foi necessaria ali.)
    - Identidade do produto: textos de descricao/instalacao/interface
      (metadata, README/LEIAME, comentarios internos, filtro de "salvar
      como") deixaram de usar nomes de empresas de terceiros como
      elemento de identidade - passaram a descrever as funcoes em termos
      proprios (ex.: "visualizador externo de imagens de satelite").
      Avisos tecnicos legitimos sobre interoperabilidade real com
      servicos externos (ex.: limitacoes de icones KML) foram mantidos,
      assim como creditos/licencas.
    - Botao "Ver no Google Earth": passa a abrir o visualizador externo
      (earth.google.com/web) centrado na FEICAO/MARCADOR selecionado no
      painel Camadas (antes so' centralizava na vista atual do canvas),
      convertendo corretamente para WGS84 a partir de qualquer SRC de
      projeto. Para poligonos concavos ou multiparte com partes
      separadas, usa um ponto GARANTIDAMENTE dentro da geometria (nao so'
      o centroide, que pode cair fora nesses casos). Sem nenhum lugar
      selecionado (ou sem geometria valida), avisa em vez de adivinhar
      uma localizacao. Versao simplificada por pedido explicito: uma
      versao intermediaria deste mesmo botao chegou a exportar a
      geometria para um arquivo KMZ temporario antes de abrir o
      visualizador - essa exportacao foi removida (nao so' desligada) -
      o botao nunca mais cria nenhum arquivo nem pasta temporaria; as
      ferramentas normais de importar/exportar KML/KMZ do GeoSketch nao
      foram alteradas.
    1.7.0
    Aderencia inteligente (Snap) com interface simplificada:
    - CORRECAO IMPORTANTE: a aderencia nunca tinha funcionado de verdade -
      snapping.py importava QgsSnappingUtils de qgis.gui, mas essa classe
      esta em qgis.core; o erro era engolido silenciosamente (nunca
      travava o desenho) e a aderencia so' caia no modo "indisponivel"
      sempre. Corrigido com fallback (qgis.core primeiro, qgis.gui
      depois, para versoes antigas) - confirmado de verdade contra o
      QGIS 3.44.15 real.
    - Novos tipos de encaixe: pontos medios e segmentos (nativos do
      QGIS, so' precisavam ser habilitados) e interseccoes/
      perpendicularidade (calculados por cima do mesmo indice espacial
      por camada que o QGIS ja mantem - QgsPointLocator.edgesInRect - sem
      varredura completa a cada movimento do mouse). Perpendicularidade
      so' aceita um ponto quando ele cai DENTRO do segmento (nunca
      extrapolado) e fica desligada por padrao (ativa nas configuracoes
      avancadas).
    - Prioridade entre alvos dentro da tolerancia: Vertice > Interseccao
      > Ponto medio > Perpendicular > Segmento, com histerese (o alvo
      anterior so' perde se o novo for CLARAMENTE melhor) para nao
      "piscar" com o cursor quase parado entre dois alvos quase
      equidistantes.
    - Indicador visual com a FORMA diferente por tipo de alvo (vertice,
      ponto medio, segmento, interseccao, perpendicular) - mesma cor e
      tamanho discretos de sempre, nunca marcadores grandes.
    - Aderencia agora tambem em mover e rotacionar geometrias (antes era
      desligada de proposito nesses modos) - inclusive ao arrastar o
      centro de rotacao.
    - Novo botao "Aderencia inteligente" na barra principal (ativado por
      padrao, liga/desliga com 1 clique) e configuracoes avancadas num
      item discreto do menu Vetor > GeoSketch (tipos de encaixe,
      tolerancia, escopo de camada ativa/todas as visiveis) - nunca
      abertas automaticamente durante o desenho. Preferencias persistidas
      via QSettings (mesmo mecanismo dos presets de estilo), sobrevivem
      entre sessoes do QGIS.
    1.6.0
    Correcao do Buffer em regioes polares e do Recorte entre feicoes da
    mesma camada:
    - Buffer: geoprocessing.suggest_projected_crs() deixa de rejeitar
      localizacoes fora da cobertura UTM (lat < -80 ou >= 84). Agora
      sugere automaticamente WGS 84 / UPS North (EPSG:32661) ou UPS South
      (EPSG:32761), validando de verdade a transformacao de coordenadas
      (nao so' isValid()) antes de usar; se a UPS nao validar nesta
      instalacao do QGIS, cai para uma projecao azimutal equidistante
      LOCAL (centrada no proprio ponto), que sempre funciona, inclusive
      exatamente nos polos. A mensagem da barra do QGIS informa qual tipo
      de projecao foi usada (UTM/UPS/local), em vez de assumir "(UTM)"
      sempre. Dentro da cobertura UTM nada mudou.
    - Recorte ("Recortar com..."): agora e' possivel recortar uma feicao
      usando OUTRA feicao da MESMA camada como mascara (ex.: camada
      "Propriedades" importada com varios poligonos - recortar um deles
      usando outro como mascara, sem precisar criar uma segunda camada).
      geoprocessing.clip_geometry() ja trabalhava so' com geometrias (sem
      restricao de camada); a janela "Recortar com..." passa a mostrar
      combos de FEICAO (ocultos quando a camada so' tem 1, aproveitando a
      selecao feita no mapa com "Selecionar" quando existir) e a validar
      por (camada, fid) em vez de so' por camada - so' a MESMA feicao nos
      dois papeis continua bloqueada (operacao sem efeito, A recortado
      por A). O dialogo de Recorte tambem passa a aceitar qualquer camada
      vetorial do projeto, nao so' lugares do GeoSketch; para uma camada
      generica, o resultado preserva o ESQUEMA e os VALORES de atributo
      originais da feicao de entrada (nova storage.
      write_single_feature_copy()), em vez do esquema nome/estilo dos
      lugares do plugin.
    1.5.0
    Rotacao de poligono, Google Earth Web, marcadores menores, compatibilidade
    QGIS 3.34+ e remocao do modelo de propriedade rural:
    - Nova ferramenta "Rotacionar" na barra de modos da edicao de geometria
      (botao direito na camada > "Editar geometria (GeoSketch)" > clicar no
      poligono no mapa): centro padrao = centroide, arrastavel (marcador
      verde, nao grava nada so' por mover o centro); arrastar dentro do
      poligono gira em torno do centro atual, sentido horario positivo
      (mesma convencao do azimute ja usada em "Adicionar por medida"/Regua);
      campo de angulo exato + botao Aplicar, com Desfazer/Refazer (Ctrl+Z/
      Ctrl+Y) integrados ao historico existente. So' a feicao em edicao e'
      girada, nunca a camada inteira; preserva multiparte e aneis internos
      (buracos) e nao grava nada antes da confirmacao (soltar o mouse ou
      clicar Aplicar).
    - "Ver no Google Maps" foi substituida por "Ver no Google Earth": abre
      https://earth.google.com/web/ centrado no mesmo ponto/zoom do canvas,
      via URL com latitude/longitude/altitude/distancia/campo de
      visao/inclinacao/rotacao - formato verificado por pesquisa, nao
      inventado. Funciona com qualquer SRC de projeto (conversao real para
      WGS84 via utils.to_wgs84, nao presume SIRGAS 2000). Validacao
      automatizada: confirma o dominio earth.google.com/web (nao mais
      google.com/maps), o formato exato da URL e as coordenadas corretas em
      SRC geografico e projetado (testado com EPSG:3857, deliberadamente
      diferente de SIRGAS 2000); nao pude abrir e renderizar visualmente a
      pagina de verdade num navegador (automacao de navegador recusada
      nesta sessao) - recomendo abrir manualmente uma vez para confirmar o
      enquadramento visual.
    - Marcadores de vertice menores durante a edicao (ICON_BOX 10px/13px
      selecionado -> 5px/6px; ponto medio 7px -> 4px), para mais precisao
      visual em poligonos com muitos vertices/segmentos proximos. A
      tolerancia de CLIQUE (GRAB_PIXELS, 14px) ficou inalterada de
      proposito - marcador menor, mesma facilidade de selecionar.
    - qgisMinimumVersion abaixado de 3.44 para 3.34: auditoria de
      compatibilidade real (nao so' o numero no metadata.txt) confirmou que
      nenhuma API usada no codigo exige algo posterior a 3.34 - inclusive
      QgsDataProvider.styleStorageCapabilities() (storage.py), que foi
      introduzida exatamente na 3.34, e ja' estava protegida por
      try/except. PyQt5 5.15.x (a mesma linha usada da 3.34 a' 3.44,
      confirmado por pesquisa) sustenta a sintaxe de enum aninhada usada em
      todo o codigo. Testado de verdade (241 testes automatizados reais)
      so' contra QGIS 3.44.15 (unico ambiente disponivel); 3.34/3.36/3.38/
      3.40/3.42 ficam tecnicamente avaliados por esta auditoria, nao
      empiricamente testados - nenhum qgisMaximumVersion foi declarado
      (QGIS 4 nao foi testado).
    - Removida a opcao "Modelo de propriedade rural" do submenu "Adicionar"
      (pedido explicito do usuario) - o item de menu e o metodo que ele
      disparava foram apagados; create_property_template/PROPERTY_TEMPLATE
      (places_model.py) e find_property_root (folder_rules.py) foram
      PRESERVADOS, porque ainda sustentam "Exportar propriedade
      completa..." (para pastas criadas com esse modelo antes desta
      remocao) e tem testes proprios em test_folder_rules.py.
    1.4.0
    Simplificacao do acesso a edicao de geometria pelo botao direito:
    - O item do menu de contexto da camada passa a se chamar "Editar
      geometria (GeoSketch)" (antes "Editar...") - mesmo icone, mesma
      posicao no submenu GeoSketch, mesmo mecanismo de edicao por baixo
      (VertexEditTool/EditDialog, sem nenhuma reconstrucao).
    - Camada importada (fora do modelo "1 lugar = 1 feicao) com 2+ feicoes:
      deixa de EXIGIR pre-selecionar 1 feicao com a ferramenta nativa
      "Selecionar" antes de abrir o menu - agora entra direto num modo de
      "clique na feicao desejada no mapa" (FeaturePickTool), restrito a
      feicoes da camada-alvo (a mesma que recebeu o botao direito nunca
      feicoes de outra camada); Esc ou clique fora de qualquer feicao
      cancela sem abrir nada. Com 1 so' feicao na camada, abre direto, sem
      nenhum clique extra. Preselecao feita de antemao continua
      funcionando (atalho, nao obrigacao).
    - Uma edicao em andamento nao e' mais substituida silenciosamente por
      outra: tentar editar uma segunda camada enquanto a janela de edicao
      da primeira ainda esta aberta mostra um aviso e traz essa janela
      para frente, em vez de trocar a camada-alvo por baixo dela.
    - O titulo da janela de edicao passa a mostrar o nome da camada (ex.:
      "GeoSketch - Editar Poligono - <camada>"), para indicar visualmente
      qual camada esta sendo editada quando ha mais de uma janela aberta.
    1.3.0
    Correcoes de geoprocessamento (Buffer e Recorte):
    - Buffer: o SRC de processamento geografico (em graus) deixa de travar
      pedindo escolha manual - agora detecta automaticamente a zona UTM
      (WGS 84) adequada pela localizacao da geometria de entrada (centro
      da extensao combinada, quando ha mais de um lugar selecionado) e usa
      ela para o calculo, sempre em metros. Funciona em qualquer lugar do
      mundo (nao assume Brasil/SIRGAS 2000). O seletor "SRC de
      processamento" e atualizado para mostrar o SRC realmente usado, e uma
      mensagem na barra do QGIS avisa qual foi. Fora da cobertura das
      zonas UTM (regioes polares) continua travando, com mensagem clara
      pedindo escolha manual - a validacao que exige SRC projetado nao foi
      removida, so' passa a raramente ser acionada.
    - Recorte: a janela "Recortar com..." agora avisa e desabilita o botao
      "Recortar" proativamente (sem precisar clicar primeiro) quando a
      camada a recortar e a mascara escolhidas sao a mesma - recortar uma
      geometria por ela mesma sempre devolve a geometria inteira sem
      alteracao (A unido com A = A), entao a restricao foi mantida (nao ha
      nenhum resultado util a desbloquear aqui, nem com uma copia da
      camada); so a mensagem e a validacao ficaram mais claras e
      antecipadas.
    1.2.0
    Modo de edicao avancada de poligonos (hibrida, estilo Google Earth Pro):
    - Barra de contexto na janela "Editar...": Editar vertices / Mover
      poligono / Desfazer / Refazer, alem do Concluir/Cancelar que ja
      existia - exibida junto do mapa, sem precisar de outra janela.
    - Nova funcionalidade "Mover poligono": clicar dentro do poligono e
      arrastar move a geometria inteira (todas as partes/aneis juntos),
      mantendo o formato exato - desfazer/refazer trata o movimento como
      UM UNICO passo, nao um por pixel arrastado.
    - A edicao de vertices (arrastar, inserir no ponto medio, apagar)
      agora funciona em QUALQUER camada vetorial do projeto (nao so nos
      lugares do plugin) pela MESMA janela/ferramenta, sem a limitacao de
      "so a maior parte e editavel" nem perda de aneis internos - uma
      camada importada com N feicoes exige 1 feicao selecionada no mapa
      antes de "Editar..." (a versao 1.1.0 usava a ferramenta nativa
      "Vertice" do QGIS para isso, que nao permite os novos recursos
      acima).
    - Corrigido bug real encontrado durante esta implementacao: editar
      (mover/inserir/apagar vertice) um poligono com anel interno (buraco)
      ou multiparte corrompia a geometria - layer.changeGeometry(), usado
      em toda edicao de vertice, truncava silenciosamente para a primeira
      parte quando a tabela do GeoPackage era declarada com tipo de
      geometria singlepart (confirmado contra o QGIS 3.44.15 real).
      Corrigido declarando a tabela como Multi* desde a criacao
      (storage.py) - sem efeito no caso comum (poligono/caminho/marcador
      singlepart continua gravando normalmente).
    - Medidas (area/perimetro/comprimento) na janela de edicao passam a
      usar a geometria completa (inclusive buracos/multiparte), em vez de
      so o anel externo simples.
    1.1.0
    Correcoes e nova funcionalidade de edicao:
    - Corrigido: "Salvar lugar como..." em KML/KMZ gerava um poligono VAZIO
      para qualquer resultado de Buffer/Uniao/Recorte/Diferenca - o
      QGIS Processing sempre devolve esses resultados como geometria
      Multi* (MultiPolygon etc.), mesmo com 1 parte so, e o exportador de
      KML proprio do plugin nao tratava isso (lancava excecao engolida em
      silencio). GeoPackage e Shapefile nunca tiveram esse problema.
      Corrigido suportando geometria multiparte na exportacao KML/KMZ;
      quando ha mais de uma parte separada, cada parte vira um Placemark
      proprio (MultiGeometry), preservando todas - antes so a primeira
      parte era mantida e as demais eram descartadas silenciosamente.
    - Corrigido o mesmo problema na edicao de vertices ("Editar..."): abrir
      um Buffer/Uniao/Recorte/Diferenca recem-criado carregava a
      ferramenta sem nenhum vertice visivel, pela mesma causa raiz.
    - Nova funcionalidade: "Editar..." agora funciona em qualquer camada
      vetorial do projeto, nao so nos lugares criados pelo proprio
      plugin - inclui KML/KMZ, GeoJSON, Shapefile e GeoPackage importados
      por fora do GeoSketch. Camadas editaveis usam a ferramenta nativa
      "Vertice" do QGIS (selecionar, mover, adicionar e remover vertice,
      geometria multiparte, desfazer/salvar via o sistema de edicao e
      transacoes do proprio QGIS). Camadas somente leitura ou sem suporte
      a edicao de geometria oferecem a opcao de criar uma copia editavel
      em GeoPackage, preservando geometria, atributos e SRC, sem alterar
      o arquivo original.
    - Linha de pre-visualizacao do desenho (poligono/caminho/circulo) mais
      fina (0,6px, antes 2px) para facilitar o posicionamento preciso de
      vertices - afeta so o traco temporario durante o desenho; a
      simbologia final da feicao salva nao foi alterada.
    1.0.0
    Lancamento oficial do GeoSketch:
    - Primeira versao oficial estavel do GeoSketch para QGIS.
    - O complemento oferece um conjunto integrado de ferramentas para
      criacao, edicao, medicao e organizacao de geometrias diretamente no
      mapa, com fluxo de trabalho inspirado no Google Earth.
    Principais recursos:
    - Criacao de pontos, linhas, poligonos e circulos.
    - Edicao de geometrias e vertices.
    - Ferramentas de medicao de areas e distancias.
    - Sistema de snapping para auxiliar na precisao dos desenhos.
    - Organizacao de elementos por pastas e subpastas.
    - Gerenciamento de estilos e propriedades.
    - Importacao e exportacao de arquivos KML e KMZ.
    - Armazenamento e organizacao dos dados em GeoPackage.
    - Ferramentas de geoprocessamento.
    - Validacao de geometrias.
    - Calculadora de areas e distancias.
    - Exportacao de mapas em PDF e PNG.
    Estabilidade e compatibilidade:
    - Correcoes de seguranca e tratamento de excecoes.
    - Ajustes de compatibilidade com as APIs Qt.
    - Melhorias de estabilidade e confiabilidade.
    - Preservacao dos dados e projetos existentes.
    0.22.0
    Qualidade de codigo:
    - Corrigidos os dois apontamentos E741 do Flake8 (nome de variavel
      ambiguo 'l'): em dlg_calculator.py, o criterio de ordenacao da lista
      de camadas passou a usar 'layer' em vez de 'l'; em layeractions.py,
      a montagem da lista de nomes na confirmacao de exclusao passou a
      usar 'place' em vez de 'l'. Nenhuma logica, calculo ou ordem de
      execucao foi alterada - so o nome das variaveis.
    0.21.0
    Correcoes e compatibilidade:
    - Correcao das enumeracoes Qt relacionadas aos atalhos de desfazer e
      refazer (QKeySequence.StandardKey.Undo/Redo, em vertexedit.py e
      maptools.py).
    - Ajustes de compatibilidade identificados pelo Qt6 Check.
    - Correcoes de inconsistencias tecnicas sem alteracao das
      funcionalidades existentes.
    0.20.0
    - Correcao dos apontamentos do Qt6 Check do repositorio oficial de
      plugins do QGIS, sem alterar nenhuma funcionalidade:
    - Todas as enumeracoes do Qt/PyQt e do PyQGIS usadas sem o escopo
      completo (ex.: QMessageBox.Yes, Qt.WindowStaysOnTopHint,
      QgsWkbTypes.PolygonGeometry) foram corrigidas para a forma escopada
      (ex.: QMessageBox.StandardButton.Yes,
      Qt.WindowType.WindowStaysOnTopHint,
      QgsWkbTypes.GeometryType.PolygonGeometry), compativel com Qt5 e Qt6
      ao mesmo tempo - a mesma tecnica recomendada
      pela ferramenta oficial de migracao do QGIS. Cobre StandardButton,
      WindowType, GeometryType, MouseButton, Key, CursorShape, PenStyle,
      IconType, AlignmentFlag, KeyboardModifier, ResizeMode,
      SelectionBehavior, SelectionMode, EditTrigger, ActionOnExistingFile,
      WriterError, MessageLevel, Orientation, ExportResult, DistanceUnit,
      DockWidgetArea, SnappingMode, UnitType, SnappingType, Icon, Type,
      State, ButtonRole, ItemFlag e CheckState, em todos os dialogos,
      ferramentas de desenho/edicao, aderencia, geoprocessamento,
      relatorios e armazenamento.
    - Todas as chamadas a dialog.exec_() (removido do Qt6) foram renomeadas
      para dialog.exec() - compativel com o PyQt5 do QGIS 3.44.15 (alias
      disponivel desde o PyQt5 5.9) e exigido pelo PyQt6, sem alterar a
      ordem de execucao de dialogos, sinais ou eventos.
    - Nenhuma ferramenta, botao, menu, icone, estrutura de pastas,
      logica de desenho/edicao/snapping/geoprocessamento ou
      importacao/exportacao KML/KMZ foi alterada - so a forma de escrever
      cada enumeracao e cada chamada de dialogo modal.
    0.19.0
    - Correcoes de seguranca e de tratamento de inconsistencias apontadas
      pelo verificador do repositorio oficial de plugins do QGIS, sem
      alterar nenhuma funcionalidade:
    - Leitura de KML/KMZ (kml_io.py) protegida contra XML malicioso
      (DOCTYPE/DTD e entidades internas/externas - 'billion laughs' e
      XXE), com um parser proprio baseado em xml.parsers.expat (sem
      depender de uma biblioteca de terceiros que poderia nao estar
      disponivel no ambiente Python do QGIS do usuario). Arquivos KML/KMZ
      legitimos continuam importando/exportando exatamente como antes
      (confirmado pelos 33 testes automatizados de kml_io.py).
    - hashlib.sha1() usado como identificador de deduplicacao em
      kml_io.fingerprint() passa a usar usedforsecurity=False (quando
      disponivel no Python do QGIS) - o mesmo algoritmo e o mesmo valor de
      hash, so marcando que o uso nao e criptografico.
    - Abrir/localizar um arquivo no gerenciador do sistema operacional
      (menu de contexto > Enviar por e-mail) deixou de iniciar processos
      por caminho parcial (ex.: "explorer"); agora resolve o executavel
      para um caminho absoluto antes de chamar subprocess.Popen, sem
      shell=True e sem concatenar texto em comando, preservando o
      comportamento em Windows/macOS/Linux.
    - Dezenas de blocos "except Exception: pass/continue" nos dialogos,
      ferramentas de desenho/edicao, aderencia, armazenamento no
      GeoPackage e organizacao de pastas foram revisados individualmente:
      falhas que podiam comprometer o funcionamento (gravacao, reversao de
      transacao, restauracao de ferramenta, limpeza de sinais) passaram a
      ser registradas no painel "Mensagens de registro" do QGIS; falhas de
      desconexao de sinal/remocao de item grafico esperadas durante o
      encerramento (ex.: objeto Qt ja destruido) foram restritas as
      excecoes especificas (TypeError/RuntimeError) em vez de Exception
      generica. Nenhuma logica de desenho, edicao, medicao, aderencia,
      importacao/exportacao, armazenamento ou gerenciamento de camadas foi
      alterada.
    0.18.0
    - Rebranding: o complemento passa a se chamar GeoSketch (nome exibido
      no Gerenciador de Complementos, na barra de ferramentas, no menu de
      contexto - agora "GeoSketch" em vez de "Ferramentas Terra" - e em
      todos os titulos de janela/caixas de mensagem). O identificador
      interno do pacote (pasta earth_tools, classe EarthTools,
      classFactory, objectName dos widgets Qt, CUSTOM_KEY gravado nas
      camadas do GeoPackage e o grupo QSettings dos presets de estilo)
      foi mantido de propósito, por compatibilidade - só o texto exibido
      ao usuario mudou, nao a estrutura de dados nem a identificacao
      interna de "isto e um lugar deste plugin".
    - Calculadora de area e distancia e Gerenciador de Estilos perdem o
      icone/entrada na barra e no menu Vetor - continuam acessiveis
      integralmente (mesma logica, callbacks e parametros de antes) pelo
      menu de contexto da camada, dentro do submenu GeoSketch
      ("Calcular medidas...", "Estilo...").
    - Preparacao para publicacao no repositorio oficial de plugins do
      QGIS: metadata.txt revisado (descricao/about traduzidos para
      ingles, categoria e tags revisadas; campos de autor/contato/URLs
      marcados como pendentes - nao preenchidos com dados inventados),
      README.md (ingles) e LICENSE (GPL-2.0-or-later) adicionados na
      raiz do projeto.
    - Icone oficial configurado (icon=icons/geosketch.png, ao inves do
      placemark.svg generico); description/about retraduzidos para
      portugues (idioma principal da documentacao); author=Gabriel
      Alberto; qgisMinimumVersion ajustado de 3.22 para 3.44 (unica
      versao com teste empirico real confirmado no historico deste
      projeto - nao declarar compatibilidade nao comprovada); tags
      normalizadas (minusculas, hifenizadas); secao "Desenvolvimento e
      autoria" adicionada ao README.md e ao LEIAME.md, deixando claro
      que ferramentas de IA foram usadas como apoio ao desenvolvimento,
      nunca como autoras do complemento; README.md e LICENSE agora
      tambem copiados para dentro de earth_tools/, para acompanhar o
      pacote instalavel (exigencia do repositorio oficial do QGIS).
      email/homepage/repository/tracker preenchidos com o repositorio
      publico do projeto (https://github.com/GabrielSa95/GeoSketch) na
      preparacao para publicacao.
    0.17.1
    - Ajuste pontual: o submenu "Adicionar" do menu de contexto da camada
      (Pasta, Modelo de propriedade rural, Marcador de local, Caminho,
      Poligono, Sobreposicao de imagem) aparecia como 5-6 entradas de topo
      SEPARADAS, todas com o nome "Adicionar" repetido, em vez de um unico
      submenu com as 6 opcoes dentro - causa raiz: cada acao era
      registrada com uma chamada propria a
      addCustomActionForLayerType(acao, "Adicionar", vector, True), e o
      QGIS nao mesclava essas 6 chamadas num unico submenu. Corrigido
      construindo um QMenu("Adicionar") proprio, com as 6 acoes como
      filhas diretas dele (API nativa do Qt), registrado uma unica vez.
      Nenhuma outra parte da interface foi alterada: textos, icones,
      callbacks, parametros e ordem das 6 opcoes sao exatamente os mesmos
      de antes; o submenu "Ferramentas Terra" categorizado (0.17.0) e o
      restante do plugin nao foram tocados.
    0.17.0
    - Auditoria e reorganizacao de interface (menu de contexto, barra de
      ferramentas e identidade visual), sem remover nem alterar nenhuma
      funcionalidade ja existente:
    - Menu de contexto da camada: as 12 acoes de lugar que ficavam soltas
      na raiz (Editar, Estilo, Buffer, Uniao, Divisao, Recortar,
      Diferenca, Salvar como, Enviar por e-mail etc.) agora ficam dentro
      de UM submenu "Ferramentas Terra", organizado por categoria
      (GEOPROCESSAMENTO, MEDICOES, VALIDACAO, EXPORTACAO) com rotulos de
      secao. Excluir continua na raiz, fora do submeno, por ser
      destrutiva. Nenhuma acao foi removida ou teve o calculo alterado -
      so a organizacao visual.
    - Novas acoes no menu de contexto: "Calcular medidas..." (abre a
      Calculadora ja no lugar clicado), "Validar geometria..." (abre o
      Validador ja com o lugar marcado) e "Exportar mapa..." (abre a
      Exportacao de mapas ja com a extensao ajustada ao lugar) - as tres
      reaproveitam as janelas que ja existiam no menu Vetor, sem duplicar
      logica de calculo/validacao/exportacao.
    - Barra de ferramentas: 4 botoes novos (Desenhar circulo - abre a
      Regua na aba Circulo; Calculadora de area e distancia; Gerenciar
      estilos; Exportar mapa) e a acao nativa "Selecionar feicoes" do
      proprio QGIS passou a tambem aparecer aqui (mesmo QAction, sem
      reimplementacao). Calculadora e Exportar mapa, que antes so tinham
      entrada no menu Vetor, agora tambem tem botao na barra - sem ficar
      duplicadas no menu.
    - Novo painel lateral "Ferramentas Terra - Propriedades" (ancoravel,
      com mostrar/ocultar pelo menu Vetor): mostra nome, tipo, area,
      perimetro/comprimento, SRC e situacao da validacao do lugar
      selecionado no painel Camadas, sempre lidos da geometria real (as
      mesmas funcoes de medicao da Calculadora/Exportar mapa) e
      atualizados ao trocar a selecao ou editar/estilizar o proprio
      lugar. Os botoes do painel (Calcular medidas, Alterar estilo,
      Validar geometria, Exportar geometria) delegam para o codigo ja
      existente, sem nenhuma logica nova de calculo/estilo/validacao/
      exportacao.
    - 4 icones novos (circulo, calculadora, paleta de estilo, exportar
      mapa), no mesmo estilo visual dos icones existentes.
    0.16.0
    - Auditoria e implementacao de 4 funcionalidades (Calculadora,
      Estilos, Validador de geometrias, Exportacao de mapas):
    - Correcao de bug real encontrado na auditoria: o estilo de um lugar
      so persistia se o PROJETO fosse salvo e reaberto - checagem de
      capacidade do provedor usava "in" sobre um tipo que nao e'
      container nesse binding do QGIS, levantando TypeError engolido em
      silencio pelo except. Corrigido com checagem bit a bit ("&");
      confirmado que o estilo agora sobrevive a reabrir a camada do
      GeoPackage sem nenhum projeto.
    - Nova Calculadora de area e distancia: consulta um lugar JA SALVO
      (sem precisar editar), com troca de unidade e botao "Copiar
      resultado". Diametro adicionado ao Circulo da Regua.
    - Novo Gerenciador de Estilos: aplica em 1+ lugares de uma vez,
      biblioteca de presets nomeados (QSettings, reutilizavel entre
      projetos).
    - Novo Validador de geometrias: geometria invalida/vazia, vertices
      duplicados, anel nao fechado, fora de uma extensao de referencia e
      sobreposicao entre poligonos (quando pedida). Correcao automatica
      (makeValid) sempre cria uma COPIA nova, nunca sobrescreve o
      original, sempre com confirmacao.
    - Nova Exportacao de mapas: layout real do QGIS (QgsPrintLayout) com
      titulo, SRC, area/perimetro, legenda, escala, seta de norte;
      formatos A4/A3, retrato/paisagem; exporta PDF e PNG reais;
      pre-visualizacao abre o Layout Designer nativo do QGIS.
    0.15.0
    - Fase F do Projeto Mestre: geoprocessamento integrado, via algoritmos
      nativos do QGIS Processing (nunca reimplementados):
    - Gerar Buffer... (native:buffer): distancia (aceita negativo, para
      encolher poligonos), unidade, numero de segmentos, SRC de
      processamento (rejeita SRC geografico com aviso claro) e de saida
      (independentes, com reprojecao efetiva), dissolver 2+ resultados,
      estilo, pasta de destino. Funciona em marcador, caminho ou
      poligono, inclusive varios ao mesmo tempo.
    - Unir poligonos... (QgsGeometry.unaryUnion): combina 2+ poligonos
      numa unica geometria.
    - Dividir poligono... (native:splitwithlines): corta um poligono com
      uma linha desenhada no mapa; pre-visualiza antes de confirmar; o
      original so e' apagado depois das partes serem gravadas com
      sucesso; avisa quando a linha nao atravessa de verdade.
    - Recortar com... (native:clip) e Diferenca... (native:difference):
      mantem a parte dentro da mascara, ou a parte fora da outra
      geometria, respectivamente.
    - Todas as operacoes preservam as camadas de origem (exceto a
      divisao, que remove o original so apos confirmar e gravar as
      partes com sucesso) - o resultado e' sempre um lugar novo.
    0.14.1
    - Correcao critica relatada pelo usuario apos testar a 0.14.0 no QGIS
      3.44.15: o Circulo continuava desenhando so a linha do raio e a
      Area aparecia como NaN; a janela "Novo Caminho" continuava sem
      opcao de SRC/CRS.
    - Causa raiz CONFIRMADA EMPIRICAMENTE contra o QGIS 3.44.15 real (ha
      uma instalacao local): QgsDistanceArea.computeSpheroidProject()
      devolve (nan, nan) SILENCIOSAMENTE - sem lancar excecao - quando o
      SRC de origem e' projetado (ex.: SIRGAS 2000/UTM, o caso comum no
      Brasil). Corrigido projetando sempre em WGS84 internamente e
      transformando o anel/ponto de volta para o SRC de origem. A mesma
      causa raiz foi encontrada e corrigida em project_point() (usada
      por "Adicionar por medida" em Novo Caminho/Novo Poligono).
    - Nova opcao "SRC/CRS da camada de saida" na janela Novo Caminho
      (antes so existia na aba Caminho da Regua): comeca no SRC do
      projeto, reprojeta de verdade as coordenadas (nao so a etiqueta do
      SRC) ao escolher outro sistema, e grava a camada ja nesse SRC.
    - Testes automatizados agora executados de verdade contra uma
      instalacao real do QGIS 3.44.15 (nao so escritos) - 136 testes
      passando.
    0.14.0
    - Reescopo priorizando desenho, medicao e geoprocessamento (estilo
      Google Earth Pro mais proximo de ferramentas de campo/CAD do que de
      um visualizador de imagens):
    - SUSPENSO: historico de imagens de satelite Sentinel-2/Landsat
      (disponivel nas versoes 0.12.0 a 0.13.1). Codigo preservado no
      historico do Git (branch feature/historico-imagens-suspenso) para
      retomada futura, se decidido - nao foi apagado, so retirado da
      interface e do empacotamento.
    - Regua > aba Caminho: novo seletor de SRC/CRS, igual ao seletor
      nativo das ferramentas de Processamento (ex.: Buffer). Comeca no
      SRC do projeto; ao trocar, o caminho salvo grava a tabela do
      GeoPackage nesse SRC (nao mais sempre em WGS84), para abrir pronto
      no Buffer com distancia em metros. Linha, Poligono e Circulo nao
      tem este seletor e continuam gravando em WGS84, como sempre.
    - Corrigido o desenho do Circulo: a circunferencia completa as vezes
      nao aparecia (so a linha pontilhada do raio) porque o calculo do
      anel usava o SRC do projeto em vez do SRC do canvas/mapa e
      descartava o anel inteiro na primeira falha de projecao de um unico
      segmento. Agora cada segmento e tentado de forma independente e o
      circulo nunca mais cai de volta para desenhar so o raio.
    - Regua: removidas as abas "Caminho em 3D" e "Poligono em 3D" (eram
      so um placeholder desativado, sem logica de medicao real).
    - Barra principal: removidos os botoes "Tela cheia" (continua pelo
      menu nativo Ver > Tela cheia do QGIS) e "Pesquisar lugares" (so
      buscava entre lugares criados pelo proprio plugin).
    0.13.1
    - Correcao critica relatada pelo usuario apos validacao manual da 0.13.0:
      a busca so trazia a primeira pagina de resultados do catalogo STAC (no
      maximo as ~30 cenas mais recentes) - por isso so o ano mais recente
      aparecia disponivel na linha do tempo. Agora pagina automaticamente
      (confirmado contra o servico real), ate 1000 cenas por busca.
    - Cada cena tem a colecao (sensor) conferida contra a fonte pedida antes
      de entrar na lista e de novo antes de carregar - corrige um produto
      Sentinel-1 (radar) aparecer rotulado como Landsat (optico), o que
      travava o carregamento com "esta cena nao tem bandas RGB suficientes".
    - Cache de busca versionado: qualquer arquivo de cache gravado por uma
      versao anterior (potencialmente incompleto/contaminado) e descartado
      automaticamente, sem precisar apagar nada a mao.
    0.13.0
    - Correcao da causa raiz do historico de imagens relatada apos a 0.12.0:
      a busca aceitava cenas que so TOCAVAM a area pesquisada (interseccao
      de bbox, nao contencao) - o usuario via, na maior parte da tela, o
      fundo do canvas fora da extensao do raster, e confundia isso com
      "imagem cinza"/"imagem que nao aparece". A lista agora mostra a
      cobertura real da area pesquisada para cada cena, sem nunca escondela.
    - Segunda causa da "imagem cinza": a composicao de bandas brutas
      (Landsat, e Sentinel-2 quando a cena nao tem o asset RGB pronto) nao
      declarava NoData nem aplicava realce de contraste - agora declara
      NoData=0 no VRT e aplica o mesmo corte cumulativo 2%%-98%% que o QGIS
      faria manualmente em Propriedades > Estilo.
    - Extensao do mapa convertida para a busca por retangulo envolvente de
      verdade (QgsCoordinateTransform.transformBoundingBox), nao só pelos
      dois cantos opostos - mais preciso em SRC projetado (SIRGAS/UTM).
    - Nova linha do tempo anual (estilo Google Earth Pro): anos reais com/
      sem aquisicao numa trilha horizontal (nunca finge disponibilidade),
      navegacao entre anos e aquisicoes sem voltar a tela de busca, pulando
      por cima de anos sem dado.
    - A imagem "atual" no mapa so e trocada depois de a nova camada ser
      validada, preservando o enquadramento do canvas; falha ao carregar
      preserva a ultima imagem valida. Resposta de uma busca antiga nunca
      mais sobrescreve o resultado de uma busca mais nova.
    - Importar/Exportar KML/KMZ saem da barra principal (menos botoes) e
      ganham atalho no botao direito de uma pasta no painel Camadas,
      incluindo "Exportar propriedade completa" a partir de uma subpasta.
    0.12.0
    - Fase E do plano Google Earth Pro: imagens de satelite e historico
      temporal.
    - Busca de Sentinel-2 e Landsat via Earth Search (Element84/AWS Open
      Data), catalogo STAC publico e sem autenticacao - confirmado contra
      o servico real durante o desenvolvimento, nao presumido.
    - Area por extensao do mapa ou feicao selecionada; periodo de datas;
      lista com data de aquisicao, data de publicacao do produto,
      satelite, resolucao e cobertura de nuvens ("Nao informado" quando a
      fonte nao traz o dado, nunca inventado).
    - Carrega a cena em cores naturais RGB direto do arquivo remoto (sem
      baixar o arquivo inteiro). Landsat compoe as 3 bandas via VRT.
    - Comparacao simples entre duas datas (Anterior/Posterior) com
      alternancia de visibilidade; aponta para a ferramenta nativa de
      mapa comparativo do QGIS para um slider, em vez de reimplementa-la.
    - Consulta assincrona (nao trava o canvas), cancelavel. Cache so de
      metadados de busca, nunca das imagens; botao para limpar.
    - Sem conexao, so esta janela e afetada - desenho, edicao, regua e
      lugares salvos continuam funcionando.
    0.11.1
    - Correcao critica: exportar pasta/propriedade para KML/KMZ gerava
      arquivo vazio (ou "nada para exportar") quando os lugares nunca
      tinham sido explicitamente movidos pelo menu ou o projeto nunca
      tinha sido salvo. A exportacao agora le a arvore de camadas visivel
      diretamente, em vez de depender so da tabela de cache de pastas.
    - A exclusao de erro agora distingue pasta invalida, pasta realmente
      vazia e falha de leitura - nunca mais mascarada como "vazio".
    - Exportar uma feicao individual nao foi afetado por este defeito e
      continua igual.
    0.11.0
    - Fase D do plano Google Earth Pro: importacao e exportacao KML/KMZ.
    - Novo leitor/escritor KML/KMZ proprio (kml_io.py), sem depender do
      driver OGR do GDAL - preserva hierarquia de pastas, nome, descricao
      e estilo (cor/largura) nos dois sentidos.
    - Importar KML/KMZ: marcador, caminho, poligono (com aneis internos),
      pastas aninhadas, selecao de elementos, pasta de destino (existente
      ou nova), deteccao de ja-importado (nao duplica ao reimportar o
      mesmo arquivo), relatorio de elementos nao suportados.
    - MultiGeometry do KML vira varios lugares separados na importacao
      (a arquitetura de 1 geometria por lugar nao foi alterada).
    - Exportar pasta (com subpastas) ou tudo para KML/KMZ. Exportar um
      lugar individual (Salvar lugar como/Enviar por e-mail) passou a usar
      o mesmo escritor, agora tambem aceitando KMZ.
    - Nao promete equivalencia visual completa com o Google Earth
      (icones personalizados, por exemplo) - documentado no LEIAME.
    0.10.0
    - Fase C do plano Google Earth Pro: desenho avancado.
    - Aderencia a vertices/segmentos de qualquer camada, usando o motor
      nativo do QGIS numa instancia propria (nao altera a configuracao
      global de snapping do projeto). Tolerancia em pixels, configuravel e
      desativavel na interface. Nao se aplica ao circulo nem a Regua.
    - Entrada numerica de vertice (aba "Adicionar por medida"): distancia e
      azimute (mesma convencao de rumo da Regua) ou coordenadas, passando
      pelo mesmo caminho de um clique real - undo, medidas, gravacao.
    - Destaque visual do vertice em arraste tambem na edicao de lugar
      existente (ja existia na criacao desde a 0.7.0).
    - Auditoria de desfazer/refazer: confirmado que cobre vertice (inserir/
      mover/apagar) na criacao e na edicao com gravacao real no GeoPackage;
      documentado que NAO cobre desfazer criacao/exclusao de uma feicao
      inteira (fora do escopo desta fase).
    0.9.0
    - Fase B do plano Google Earth Pro: organizacao de lugares em pastas e
      subpastas persistentes, guardadas no proprio GeoPackage (nao so no
      projeto QGIS), entao sobrevivem mesmo sem salvar o projeto.
    - Criar/renomear/excluir pasta; mover lugar entre pastas pelo menu
      "Mover para pasta..." ou por arrastar-e-soltar nativo do QGIS.
    - Mostrar/ocultar pasta inteira (recurso nativo do QGIS, aplicado aos
      lugares dentro dela).
    - Modelo reutilizavel de propriedade rural (Sede, Area do Imovel, APP,
      Reserva Legal, Nascentes, Outros).
    - Pesquisa de lugares por nome com navegacao direta até a feicao.
    - Exclusao de pasta agora tambem limpa o registro de pastas/subpastas no
      GeoPackage, para nao deixar dado orfao.
    0.8.0
    - Fase A do plano Google Earth Pro: desfazer/refazer (Ctrl+Z/Ctrl+Y) para
      adicionar, mover e apagar vertices, tanto na criacao quanto na edicao
      de um lugar existente (regrava o GeoPackage a cada passo).
    - Novo botao "Ir para coordenadas" (digita lat/lon e centraliza o mapa).
    - Nova acao "Ir para" no menu de lugares, que amplia o mapa até a feicao
      selecionada usando o zoom nativo do QGIS.
    - Novo botao de tela cheia na barra, reaproveitando o recurso nativo do
      QGIS (View > Tela cheia) em vez de um modo proprio.
    - Diagnostico: falhas de gravacao/exclusao agora tambem ficam registradas
      no painel nativo "Mensagens de registro" do QGIS, alem do aviso na
      tela, para investigacao posterior.
    0.7.0
    - Durante a criacao de caminhos e poligonos, agora e possivel selecionar,
      arrastar e apagar um vertice individual sem reiniciar o desenho.
    - A exclusao de vertices (na criacao e na edicao) passa a considerar
      vertices distintos, nao so a contagem de cliques, e bloqueia a
      operacao com aviso quando isso deixaria a geometria invalida.
    - Corrigidas falhas silenciosas de gravacao: renomear, salvar descricao
      e mover vertice de um lugar existente agora avisam o usuario quando a
      gravacao no GeoPackage falha, em vez de dar falso sucesso.
    - A exclusao de lugares agora confirma se a tabela foi mesmo removida do
      GeoPackage e avisa quando ela nao pode ser apagada do arquivo.
    0.6.0
    - Versao anterior.
