MopaCraft Background 🎨🎬

Extensão para o Visual Studio Code que permite aplicar vídeos (MP4, WebM), GIFs animados ou imagens de alta resolução como plano de fundo de toda a interface do VS Code, com transparência configurável e segurança contra corrupção de arquivos.

Compatível com Windows, macOS e Linux.

✨ Recursos

• 🎬 Suporte a Vídeo: Reproduza vídeos .mp4 e .webm com aceleração de hardware GPU.
• 🖼️ Suporte a GIFs e Imagens: Suporta .gif, .png, .jpg, .webp e .svg.
• 🪟 Transparência Granular: Sliders independentes para controlar a opacidade do Editor de Código, Barra Lateral (Explorer) e Painel Inferior / Terminal, mantendo o código sempre legível.
• ⚡ Otimização Inteligente de Energia: Pausa o vídeo automaticamente quando o VS Code é minimizado ou perde o foco para poupar CPU e bateria.
• 🛡️ Segurança Contra Quebra (No-Break Guarantee):
  • Criação de backup atômico de fábrica antes de qualquer alteração (workbench.html.mopacraft.backup).
  • Injeção delimitada por tags estritas: desinstalar ou desativar remove 100% do código injetado sem tocar no VS Code original.
• 🔒 Silenciador Nativo de Checksum: Atualiza automaticamente os hashes no product.json para evitar o aviso de "Your Code installation is corrupt".
• 🔑 Elevação Nativa de Permissões: Quando o VS Code estiver em pastas de sistema (C:\Program Files, /Applications, /usr/share/code), a extensão solicita privilégios via diálogo nativo do SO (UAC no Windows, janela gráfica no macOS via osascript, pkexec no Linux).
• 🔄 Detecção de Atualização do VS Code: Detecta quando o VS Code foi atualizado e oferece um botão para reaplicar suas preferências em 1 clique.

🚀 Como Usar

1. Pelo Menu de Acesso Rápido

Clique no item $(file-media) MopaCraft no canto inferior direito da barra de status ou abra a paleta de comandos (Ctrl+Shift+P ou Cmd+Shift+P):

1. Execute: MopaCraft: Escolher Mídia de Fundo...
2. Selecione um vídeo (.mp4), GIF ou imagem do seu computador (ou cole uma URL https://).
3. Clique em Sim, Aplicar Agora.
4. Recarregue a janela quando solicitado.

2. Comandos Disponíveis na Paleta (Ctrl+Shift+P / Cmd+Shift+P)

⚙️ Configurações (settings.json)

Você pode personalizar todas as opções no menu de configurações do VS Code (mopacraft):

{
  // Caminho do arquivo local ou URL https
  "mopacraft.mediaPath": "/Users/usuario/Downloads/wallpaper.mp4",

  // Tipo de mídia: 'auto', 'video', 'gif' ou 'image'
  "mopacraft.mediaType": "auto",

  // Opacidade da mídia de fundo (0.0 transparente a 1.0 visível)
  "mopacraft.backgroundOpacity": 0.8,

  // Opacidade do fundo do editor de texto (0.0 totalmente transparente a 1.0 sólido escuro)
  "mopacraft.editorOpacity": 0.2,

  // Opacidade da barra lateral
  "mopacraft.sidebarOpacity": 0.80,

  // Opacidade do terminal e painel inferior
  "mopacraft.panelOpacity": 0.80,

  // Desfoque (blur) aplicado ao fundo em pixels
  "mopacraft.blur": 0,

  // Pausar vídeo ao perder o foco para poupar CPU/GPU
  "mopacraft.autoPauseOnBlur": true,

  // Atualizar product.json automaticamente para remover aviso de instalação corrompida
  "mopacraft.autoFixChecksums": true,

  // Repetição em loop
  "mopacraft.loop": true,

  // Mudo
  "mopacraft.muted": true
}

🛠️ Compilação e Desenvolvimento Local

Para compilar e testar a extensão localmente:

cd /Users/akin/dev/vscode-mopacraft

# Instalar dependências
npm install

# Executar testes automatizados
npm test

# Compilar TypeScript
npm run compile

# Gerar pacote .vsix para instalação manual
npm run package

📦 Como Publicar no Visual Studio Marketplace

A publicação na loja oficial do VS Code é gratuita e leva poucos minutos.

1. Criar sua Conta de Publicador (Publisher)

1. Acesse o portal de gerenciamento de extensões: marketplace.visualstudio.com/manage.
2. Faça login com sua conta Microsoft.
3. Clique em Create publisher (Criar publicador).
4. Defina o seu ID de publicador (deve corresponder ao campo "publisher" no seu package.json, ex: "mopacraft").

Opção A: Publicação pelo Navegador (Recomendada - Mais Fácil)

Como o arquivo .vsix é gerado automaticamente pelo projeto:

1. Gere o pacote mais recente:

   npm run package
   

2. Acesse marketplace.visualstudio.com/manage.
3. Selecione seu publicador e clique em + New extension > Visual Studio Code.
4. Arraste ou selecione o arquivo vscode-mopacraft-1.0.0.vsix gerado na raiz.
5. Clique em Upload. Em 2 a 5 minutos a extensão estará disponível publicamente na loja.

Opção B: Publicação pelo Terminal (via vsce)

1. Criar o Token de Acesso (PAT)

1. Acesse dev.azure.com com a mesma conta Microsoft.
2. No canto superior direito, clique no ícone de engrenagem (User settings) > Personal access tokens.
3. Clique em + New Token:
   • Name: VSCE Marketplace
   • Organization: Selecione All accessible organizations (obrigatório).
   • Scopes: Clique em Show all scopes, localize Marketplace e marque Manage (ou Full access).
4. Clique em Create e copie o token gerado.

2. Autenticar e Publicar

No terminal da pasta do projeto:

# Fazer login com o publisher (cole o token gerado quando solicitado)
npx vsce login mopacraft

# Publicar na loja
npx vsce publish

Dica para novas versões: sempre que lançar novidades, incremente a versão no package.json (ou use npx vsce publish patch) e publique novamente.

📄 Licença

MIT License.