Resolver avisos de cópia e entrega

O Pinar usa primeiro a API de área de transferência do navegador por um documento em segundo plano e recorre a uma seleção de texto oculta quando permissão ou foco bloqueiam a cópia. Se todos os mecanismos falharem, a sobreposição é restaurada para manter pins e comentários editáveis.

screenshot_missing significa que a imagem não pôde ser persistida. helper_unavailable indica que o serviço local não foi alcançado. viewer_unavailable indica que não houve URL do visualizador. Continue com o comentário, o caminho DOM, o seletor, as coordenadas do pin, captureId e pinId e tente de novo só a camada ausente.

A cópia exige um comentário salvo e pelo menos um pin. A barra mostra “Salvando sessão…”, esconde as sobreposições, captura a imagem e pede a um documento em segundo plano para gravar text/html e text/plain. Esse documento tenta primeiro a API de área de transferência do navegador e recorre a um evento de cópia do documento. Se essa gravação não for bem-sucedida, a página ainda tenta copiar o texto simples devolvido, inclusive por uma seleção oculta em um campo de texto.

Quando todos os caminhos de cópia falham, a página restaura as sobreposições, mostra “Falha ao copiar” e deixa os pins editáveis. Uma cópia bem-sucedida mostra “Copiado com sucesso!”, ou “Copiado com sucesso!” seguido de “sem captura”, “auxiliar indisponível” ou “sem visualizador”, e então encerra a sessão. Esses sufixos correspondem a screenshot_missing, helper_unavailable e viewer_unavailable. screenshot_inline não é um dos avisos de entrega degradada. Um texto colado sem a cerca fechada pinar-visual-context não pode ser lido como JSON.

• Se a barra disser “Escreva um comentário” ou “Adicione um pin”, conclua o pin e pressione Command+Enter / Alt+Enter de novo.
• Se aparecer “Falha ao copiar”, confirme que os pins ainda estão na página, conceda permissão de área de transferência se pedirem e tente copiar de novo.
• Leia o sufixo de “Copiado com sucesso!”: “sem captura”, “auxiliar indisponível” e “sem visualizador” nomeiam a camada ausente a retentar sem descartar comentários.

Quando a conclusão falha porque o screenshot final não pode ser capturado, a barra mostra uma dessas mensagens em vez de um erro genérico, e a sessão fica na página para uma nova tentativa. Cada mensagem nomeia a causa e a correção:

• “Um pin está fora da área visível · traga-o para a área visível e tente novamente” — role até o elemento pinado ficar visível e conclua a sessão de novo.
• “A página mudou durante a captura · permaneça nela e tente novamente” — conclua de novo a partir da página anotada sem sair dela.
• “A aba anotada não estava ativa · volte a ela e tente novamente” — volte para a aba anotada e conclua de novo.
• “Screenshot não capturado · volte à página anotada e tente novamente” — volte à página anotada e conclua de novo.