🛡️ Guardian — Proteção de Conteúdo para Famílias

Extensão Chrome que monitora as legendas do YouTube em tempo real e bloqueia vídeos com palavras impróprias para crianças e idosos.

Funciona 100% offline — sem APIs externas, sem custo, sem envio de dados.

---

Como instalar e rodar

1. Pré-requisitos

• Node.js versão 18 ou superior
• Google Chrome

2. Instalar dependências

npm install

3. Fazer o build

# Build de produção (uma vez)
npm run build

# Build de desenvolvimento com watch (recompila ao salvar)
npm run dev

Isso vai gerar a pasta /dist com os arquivos compilados.

4. Carregar no Chrome

1. Abra o Chrome e vá em chrome://extensions
2. Ative o Modo do desenvolvedor (canto superior direito)
3. Clique em "Carregar sem compactação"
4. Selecione a pasta raiz do projeto (guardian-extension/)
5. A extensão aparece na barra do Chrome ✅

Toda vez que você modificar o código, rode npm run build e clique no botão 🔄 em chrome://extensions.

---

Como usar

1. Clique no ícone 🛡️ na barra do Chrome
2. Escolha o perfil (Idosa ou Criança)
3. Escolha a ação (Pausar, Mutar, Pular ou Bloquear tela)
4. Adicione palavras extras se quiser
5. Pronto — o Guardian monitora automaticamente todo vídeo do YouTube

---

Personalizar as palavras

Edite o arquivo src/wordlist.ts e adicione ou remova palavras das listas crianca e idosa.

Após editar, rode npm run build e atualize a extensão no Chrome.

---

Estrutura de arquivos

guardian-extension/
├── src/
│   ├── content.ts      ← roda dentro da aba do YouTube
│   ├── background.ts   ← service worker (gerencia estado)
│   ├── analyzer.ts     ← detecta palavras no texto
│   ├── actions.ts      ← pausa, muta, bloqueia tela
│   ├── wordlist.ts     ← ⭐ suas listas de palavras
│   └── types.ts        ← interfaces TypeScript
├── popup/
│   ├── popup.html      ← painel da extensão
│   ├── popup.ts        ← lógica do painel
│   └── popup.css       ← estilos do painel
├── dist/               ← gerado pelo build (não edite)
├── manifest.json       ← configuração da extensão
├── webpack.config.js   ← empacotador
├── tsconfig.json       ← configuração TypeScript
└── package.json

---

Licença

MIT — use, modifique e distribua à vontade. Feito com ❤️ para proteger famílias.